Kuruluşun ilk katılım süreci

Private Cloud için Edge v4.18.05

İlk katılım sürecini gerçekleştirmek için setup-org komut dosyasını kullanın. Komut dosyasını Yönetim Sunucusu düğümünde çalıştırmanız gerekir.

Bir kuruluşu ilk katılıma kaydetmek için:

  1. Yönetim sunucusu düğümüne apigee-provision'ü yükleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Yönetim sunucusu düğümünde setup-org komut dosyasını çalıştırın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Yapılandırma dosyası, "apigee" kullanıcısı tarafından okunabilir olmalıdır. Örnek yapılandırma dosyası için Oryantasyon yapılandırma dosyası başlıklı makaleyi inceleyin.

  3. Bir kuruluşu başarıyla ilk katılıma kaydettiğinizi doğrulayın. Bunu yapmanın bir yolu, tarayıcıda aşağıdaki URL'yi isteyerek kullanıcı arayüzüne 
    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 Oryantasyon sürecini doğrulama başlıklı makaleyi inceleyin.

  4. İlk proxy'nizi oluşturun.

İlk katılım yapılandırma dosyası

setup-org komut dosyasıyla sessiz bir yapılandırma gerçekleştirmek için aşağıdaki örnekte gösterildiği gibi, -f seçeneğini kullanarak bir yapılandırma dosyası iletin:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

Bu bölümde, bir kuruluşu setup-org ile ilk katılım için örnek bir yapılandırma dosyası yer almaktadır.

setup-org komut dosyası, bir kuruluşu ilk katılım sırasında şunları yapar:

  • Yeni bir kuruluş oluşturur.
  • Bir ortam oluşturur.
  • Ortam için sanal ana makine oluşturur.
  • Belirtilen kullanıcıyı kuruluş yöneticisi olarak ayarlar. Unutmayın:
    • Kuruluş yöneticisi için mevcut bir kullanıcıyı kullanabilir veya yeni bir kullanıcı oluşturabilirsiniz.
    • Kuruluş yöneticisi, sistem yöneticisiyle aynı olmamalıdır.
  • Kuruluşu "ağ geçidi" kapsülüyle ilişkilendirir. (Bu varsayılan ayardır ve değiştirilemez.)
  • Ortamı tüm Mesaj İşleyicileri ile ilişkilendirir.
  • Analizleri etkinleştirir.

Aşağıdaki örneği kopyalayıp kuruluşunuzu ilk katılıma hazırlamak için gerektiği şekilde düzenleyin:

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.

Notlar:

  • 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 (örneğin, "myapi.example.com"). Henüz DNS kaydınız yoksa yönlendiricinin IP adresini kullanabilirsiniz.

    Sanal ana makinenin nasıl yapılandırılacağı 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'yi yapılandırmayla ilgili diğer yönler hakkında daha fazla bilgi edinmek üzere Anahtar depoları ve güven depoları ile Private Cloud için bir API'ye TLS erişimini yapılandırma başlıklı makalelere bakın.
  • Sanal ana makineleri yapılandırma hakkında daha fazla bilgi için Özel Bulut için bir API'ye TLS erişimini yapılandırma başlıklı makaleyi inceleyin.
  • Aynı ada sahip iki kuruluş oluşturamazsınız. Bu durumda, ikinci oluşturma işlemi başarısız olur.

Bir kuruluşu ilk kez kullanmaya başlamak için yönetim API'sini kullanma hakkında daha fazla bilgi edinmek isterseniz Kuruluş, ortam ve sanal ana makine oluşturma başlıklı makaleyi inceleyin.

İ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ı vererek sistemin durumunu doğrulayın:

  1. Aşağıdaki komutları çalıştırarak Yönetim Sunucusu'ndaki 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
  2. Aşağıdaki komutu yürüterek analizleri kontrol edin: 
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. Düğüm 2'de aşağıdaki komutları çalıştırarak PostgreSQL veritabanı 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 isteminde aşağıdaki komutu girin:

    \d analytics."org_name.env_name.fact"

    psql'den çıkmak için aşağıdaki komutu kullanın:

    \q
  4. Web tarayıcısı kullanarak Apigee Edge kullanıcı arayüzüne erişin. Kurulumun sonunda Yönetici Konsolu URL'sini kaydettiğinizi unutmayın.
    1. Tercih ettiğiniz tarayıcıyı başlatın ve Edge kullanıcı arayüzünün URL'sini girin. IP adresi 1. düğümün (yükleme topolojilerinde gösterildiği gibi) veya alternatif yapılandırmalar için kullanıcı arayüzünü yüklediğiniz düğümün olduğu şuna benzer: 
      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çimteki bir URL kullanabilirsiniz: 

      http://localhost:9000/login

    2. Konsol giriş sayfasında Apigee sistem yöneticisi kullanıcı adını/şifresini belirtin.
  5. Yeni bir Apigee kullanıcı hesabına kaydolun ve yeni kullanıcı kimlik bilgisini kullanarak giriş yapı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şturma

Yeni bir kuruluşu ilk kez dahil ettikten 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 bölümüne bakın.

Faydalı bulabileceğiniz diğer kaynaklar: