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

Bir kuruluşu kullanıma almak için bir 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.

Yönetim API'sini kullanarak bir kuruluşu ilk kullanıma hazırlama hakkında bilgi edinmek için 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şu kullanıma alma için örnek bir yapılandırma dosyası yer alır.

Aşağıdaki örneği kopyalayın ve kuruluşunuz için gerekli şekilde düzenleyin:

# Specify the IP or DNS name of the Management Server.
IP1=MANAGEMENT_SERVER_IP_ADDRESS

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ı (ör. "myapi.example.com") belirtin. 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 oluşturma başlıklı makaleyi inceleyin.

  • TLS/SSL yapılandırması için JAR dosyasını oluşturma ve TLS/SSL yapılandırmasının diğer yönleri hakkında daha fazla bilgi edinmek üzere Keystores and Truststores (Anahtar Depoları ve Güven Depoları) ve Configuring TLS access to an API for the Private Cloud (Private Cloud için bir API'ye TLS erişimini yapılandırma) başlıklı makaleleri inceleyin.
  • Sanal ana makineleri yapılandırma hakkında daha fazla bilgi için Özel bulut için 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 çalıştırın

Oryantasyon yapılandırma dosyasını oluşturduktan sonra oryantasyon işlemini gerçekleştirmek için dosyayı setup-org komut dosyasına iletirsiniz. Komut dosyasını Yönetim Sunucusu düğümünde çalıştırmanız gerekir.

Bir kuruluşu ilk kullanıma hazırlarken setup-org komut dosyası şunları yapar:

  • Yeni bir kuruluş oluşturur.
  • 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 "gateway" pod'uyla ilişkilendirir. (Bu varsayılan ayardır ve değiştirilemez.)
  • Ortamı tüm Mesaj İşlemcilerle ilişkilendirir.
  • Analizleri etkinleştirir.

setup-org komutunu çalıştırmak için:

  1. Yönetim sunucusu düğümüne apigee-provision yükleyin: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. setup-org komut dosyasını Yönetim Sunucusu düğümünde ç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 okunabilir olmalıdır.

  3. Bir kuruluşu başarıyla dahil ettiğinizi doğrulayın. Bunu yapmanın bir yolu, bir tarayıcıda aşağıdaki URL'yi isteyerek yeni Edge kullanıcı arayüzüne giriş yapmaktır: 
    http://IP_address:3001

    Burada IP_address, Yeni 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.

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

  1. 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
  2. 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
  3. Düğüm 2'de aşağıdaki komutları çalıştırarak PostgreSQL veritabanı durumunu kontrol edin (kurulum topolojilerinde gösterildiği gibi): 
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    Komut isteminde, kuruluşunuzun analiz tablosunu görüntülemek için 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 yeni Edge kullanıcı arayüzüne erişin. Yönetim konsolu URL'sini kurulumun sonunda not ettiğinizi unutmayın.
    1. Tercih ettiğiniz tarayıcıyı başlatın ve Yeni Edge kullanıcı arayüzünün URL'sini girin. Aşağıdakine benzer bir görünümü vardır. IP adresi, 1. düğüm (kurulum topolojilerinde gösterildiği gibi) veya alternatif yapılandırmalar için yeni Edge kullanıcı arayüzünü yüklediğiniz düğüme aittir: 
      http://192.168.56.111:3001

      3001, yeni Edge kullanıcı arayüzü tarafından kullanılan varsayılan bağlantı noktası numarasıdır.

      Tarayıcıyı doğrudan Yeni Edge kullanıcı arayüzünü barındıran sunucuda başlatıyorsanız şu biçimde bir URL kullanabilirsiniz: 

      http://localhost:3001
    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 oturum açmak için yeni kullanıcı kimlik bilgilerini kullanın. Konsol oturum açma sayfasında Oturum Aç düğmesini tıklayın.

    Tarayıcı http://192.168.56.111:3001/edge adresine yönlendirilir ve oluşturduğunuz kuruluşu yapılandırmanıza olanak tanıyan bir kontrol paneli açılır (Apigee yönetici kimlik bilgileriyle giriş yaptıysanız).

İlk proxy'nizi oluşturma

Yeni bir kuruluşun oryantasyonunu tamamlayıp oryantasyon 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ı makaleyi inceleyin.

Yararlı bulabileceğiniz diğer kaynaklar: