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

Private Cloud için Edge v4.19.01

Bir kuruluşu ilk katılıma dahil etmek için ilk katılım yapılandırma dosyası oluşturmanız ve ardından bu dosyayı setup-org komutuna iletmeniz gerekir. Bu adımların her biri sonraki bölümlerde açıklanmıştır.

Bir kuruluşu ilk kez kullanmaya başlamak için yönetim API'sini kullanma hakkında bilgi edinmek isterseniz 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, setup-org ile bir kuruluşun ilk katılımına ilişkin örnek bir yapılandırma dosyası bulunmaktadır.

Aşağıdaki örneği kopyalayıp kuruluşunuza uygun ş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.

Aşağıdakileri 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 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 oluşturma başlıklı makaleyi inceleyin.

  • TLS/SSL yapılandırmasıyla ilgili olarak, JAR dosyası oluşturma ve TLS/SSL'yi yapılandırmayla ilgili diğer konular hakkında daha fazla bilgi edinmek için Anahtar Depoları ve Truststore'lar ve 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.

setup-org komutunu yürütme

İlk katılım yapılandırma dosyasını oluşturduktan sonra, ilk katılım sürecini gerçekleştirmek için dosyayı setup-org komut dosyasına iletirsiniz. Yönetim Sunucusu düğümünde komut dosyasını ç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 bir 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 İşleyicilerle ilişkilendirir.
  • Analizleri etkinleştirir.

setup-org'i yürütmek 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 ve komut dosyasını, İ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 okunabilir olmalıdır.

  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ı doğrulama

İlk katılım tamamlandığında, yönetim sunucusu düğümünde aşağıdaki curl komutlarını göndererek sistemin durumunu doğrulayın:

  1. Aşağıdaki komutları yürüterek 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. Şu komutu çalıştırarak analizleri kontrol edin: 
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. 2. düğümde aşağıdaki komutları yürüterek 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. Aşağıdakine benzerdir. Burada IP adresi Düğüm 1'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 aittir: 
      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 URL'yi şu biçimde 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. Konsolda 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: