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

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:

  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 İ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.

  3. 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.

  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ını yayınlayarak 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ı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
  4. 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.
    1. 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

    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 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: