Bir kuruluşun ilk katılım işlemini gerçekleştirmek için ilk katılım yapılandırma dosyası oluşturup bu dosyayı setup-org
komutuna iletmeniz gerekir. Bu adımların her biri sonraki bölümlerde açıklanmıştır.
Bir kuruluşun katılımını gerçekleştirmek için Management API'yi kullanma hakkında bilgi edinmek üzere Kuruluş, ortam ve sanal ana makine oluşturma başlıklı makaleyi inceleyin.
İlk katılım yapılandırma dosyası oluşturma
Bu bölümde, bir kuruluşun setup-org
ile ilk katılımı için örnek bir yapılandırma dosyası yer alır.
Aşağıdaki örneği kopyalayıp kuruluşunuz için gerekli düzenlemeleri yapın:
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=admin_password # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user # Org admin password must be at least 8 characters long and contain one uppercase # letter, one lowercase letter, and one digit or special character USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # lowercase only # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
Unutmayın:
VHOST_ALIAS
için, sanal ana makineye erişmek üzere kullanacağınız bir DNS kaydınız varsa ana makine takma adını ve isteğe bağlı olarak bağlantı noktasını belirtin (ör. "myapi.example.com"). Henüz bir DNS kaydınız yoksa Yönlendiricinin IP adresini kullanabilirsiniz.
Sanal ana makineyi yapılandırma hakkında daha fazla bilgi için Sanal ana makine ayarlama bölümüne bakın.
- TLS/SSL yapılandırması için JAR dosyası oluşturma ve TLS/SSL yapılandırmanın diğer yönleri hakkında daha fazla bilgi edinmek üzere Anahtar Depoları ve Truststore'lar ve Private Cloud için bir API'ye TLS erişimini yapılandırma bölümlerine bakın.
- Sanal ana makineleri yapılandırma hakkında daha fazla bilgi edinmek için Private Cloud için bir API'ye TLS erişimini yapılandırma bölümüne bakın.
- Aynı ada sahip iki kuruluş oluşturamazsınız. Bu durumda, ikinci oluşturma işlemi başarısız olur.
Kurulum kuruluşu yürütme
İlk katılım yapılandırma dosyasını oluşturduktan sonra, bu dosyayı setup-org
komut dosyasına iletirsiniz. Komut dosyasını Yönetim Sunucusu düğümünde çalıştırmanız gerekir.
Bir kuruluşun ilk katılımı sırasında setup-org
komut dosyası şunları yapar:
- Yeni bir kuruluş oluşturur.
- Ortam oluşturur.
- Ortam için sanal bir ana makine oluşturur.
- Belirtilen kullanıcıyı kuruluş yöneticisi olarak ayarlar. Unutmayın:
- Mevcut bir kullanıcıyı kullanabilir veya kuruluş yöneticisi için yeni bir kullanıcı oluşturabilirsiniz.
- Kuruluş yöneticisi, sistem yöneticisi ile aynı olmamalıdır.
- Kuruluşu "ağ geçidi" kapsülüyle ilişkilendirir. (Bu, varsayılan değerdir ve değiştirilemez.)
- Ortamı tüm Mesaj İşleyicileriyle ilişkilendirir.
- Analizleri etkinleştirir.
setup-org
komutunu yürütmek için:
- Yönetim Sunucusu düğümüne
apigee-provision
yükleyin:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- Yönetim Sunucusu düğümünde
setup-org
komut dosyasını çalıştırın ve İlk katılım yapılandırma dosyası oluşturma bölümünde oluşturduğunuz yapılandırma dosyasına yönlendirin:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Yapılandırma dosyası, "Apigee" kullanıcısı tarafından okunabilmelidir.
- Kuruluşun ilk katılım sürecini başarıyla tamamladığınızı doğrulayın. Bunu yapmanın bir yolu, tarayıcıda aşağıdaki URL'yi isteyerek kullanıcı arayüzüne giriş yapmaktır:
http://IP_address:9000/login
Burada IP_address, Edge kullanıcı arayüzünü yüklediğiniz sunucunun IP adresidir.
Ek doğrulama adımları için İlk katılımı doğrulama başlıklı makaleyi inceleyin.
- İlk proxy'nizi oluşturun.
İlk katılımı doğrulama
İlk katılım tamamlandıktan sonra Yönetim Sunucusu düğümünde aşağıdaki curl
komutlarını yayınlayarak sistemin durumunu doğrulayın:
- Aşağıdaki komutları çalıştırarak Yönetim Sunucusu'nda kullanıcı ve kuruluş durumunu kontrol edin:
curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations/org_name/deployments
- Aşağıdaki komutu çalıştırarak analizleri kontrol edin:
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- Düğüm 2'de aşağıdaki komutları çalıştırarak PostgreSQL veritabanının durumunu kontrol edin (yükleme topolojilerinde gösterildiği gibi):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
Kuruluşunuzun analiz tablosunu görüntülemek için komut istemine aşağıdaki komutu girin:
\d analytics."org_name.env_name.fact"
psql'den çıkmak için aşağıdaki komutu kullanın:
\q
- Apigee Edge kullanıcı arayüzüne bir web tarayıcısı kullanarak erişin. Yükleme işleminin sonunda Yönetim Konsolu URL'sini not ettiğinizi unutmayın.
- Tercih ettiğiniz tarayıcıyı başlatın ve Edge kullanıcı arayüzünün URL'sini girin. IP adresinin Düğüm 1 için (yükleme topolojilerinde gösterildiği gibi) veya alternatif yapılandırmalar için kullanıcı arayüzünü yüklediğiniz düğüme yönelik olduğu aşağıdaki gibi görünür:
http://192.168.56.111:9000/login
9000, kullanıcı arayüzü tarafından kullanılan bağlantı noktası numarasıdır.
Tarayıcıyı doğrudan Edge kullanıcı arayüzünü barındıran sunucuda başlatıyorsanız şu biçimde bir URL kullanabilirsiniz:
http://localhost:9000/login
- Konsol giriş sayfasında Apigee sistem yöneticisi kullanıcı adını/şifresini belirtin.
- Tercih ettiğiniz tarayıcıyı başlatın ve Edge kullanıcı arayüzünün URL'sini girin. IP adresinin Düğüm 1 için (yükleme topolojilerinde gösterildiği gibi) veya alternatif yapılandırmalar için kullanıcı arayüzünü yüklediğiniz düğüme yönelik olduğu aşağıdaki gibi görünür:
- Yeni bir Apigee kullanıcı hesabına kaydolun ve giriş yapmak için yeni kullanıcı kimlik bilgisini kullanın. Konsol oturum açma sayfasında Oturum Aç düğmesini tıklayın.
Tarayıcı
http://192.168.56.111:9000/platform/#/org_name/
adresine yönlendirir ve oluşturduğunuz kuruluşu yapılandırmanıza olanak tanıyan bir kontrol paneli açar (Apigee yönetici kimlik bilgilerini kullanarak giriş yaptıysanız).
İlk proxy'nizi oluşturun
Yeni bir kuruluşun katılımını gerçekleştirdikten ve ilk katılım sürecinin başarılı olduğunu doğruladıktan sonra ilk proxy'nizi oluşturabilirsiniz. Daha fazla bilgi için İlk API proxy'nizi oluşturma başlıklı makaleye bakın.
Yararlı bulabileceğiniz diğer kaynaklar şunlardır: