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

Edge for Private Cloud 4.18.01 sürümü

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

İlk katılım süreci kapsamında komut dosyası:

  • Kuruluşu oluşturur.
  • Belirtilen kullanıcıyı kuruluş yöneticisi olarak ayarlar.
    • Bu kullanıcı, sistem yöneticisi kullanıcısından farklı olmalıdır. Yani sistem yöneticisi kullanıcısını kuruluş yöneticisi kullanıcısı olarak kullanmayın.
    • Kuruluş yöneticisi için mevcut bir kullanıcıyı belirtebilir veya komut dosyasını yeni bir kullanıcı oluşturacak şekilde yapılandırabilirsiniz.
  • Kuruluşu bir pod ile ilişkilendirir. Varsayılan olarak "gateway" pod'u ile ilişkilendirir.
  • Bir ortam oluşturun.
  • Ortam için sanal ana makine oluşturun.
  • Ortamı tüm Mesaj İşleyicilerle ilişkilendirin.
  • Analizleri etkinleştirir.

İlk katılım için yapılandırma dosyası

setup-org komutuna bir yapılandırma dosyası iletin. setup-org komutunu çağırın ve sessiz yapılandırma dosyasının yolu da dahil olmak üzere -f seçeneğini belirtin:

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

Sessiz yüklemelerle ilgili tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır.

Aşağıda örnek bir sessiz yapılandırma dosyası gösterilmektedir. Gereksinimlerinize göre 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=adminPassword     # 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
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

# 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 zaten 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 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 inceleyerek JAR dosyasını oluşturma ve TLS/SSL yapılandırmasının diğer yönleri hakkında daha fazla bilgi edinin.
  • 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.

İlk katılım prosedürü

  1. Yönetim Sunucusu düğümüne apigee-provision'u yükleyin:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Yönetim Sunucusu düğümünde şu komutu ç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 erişilebilir veya okunabilir olmalıdır.

İlk katılım doğrulaması

Oryantasyon tamamlandığında, Yönetim Sunucusu düğümünde aşağıdaki CURL komutlarını vererek sistemin durumunu doğrulayın.

  1. Aşağıdaki CURL komutlarını vererek 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/<orgname>/deployments
  2. Analizleri etkinleştirdiyseniz şu komutu kullanın:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. PostgreSQL veritabanı durumunu kontrol etmek için psql'i başlatmak üzere 2. makinede aşağıdaki komutu da çalıştırabilirsiniz:
    > 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:
    apigee=# : \d analytics."<orgname>.prod.fact"

    psql'den çıkmak için aşağıdaki komutu kullanın:
    apigee=# \q
  4. Bir web tarayıcısı kullanarak Apigee Edge kullanıcı arayüzüne erişme Yönetim konsolu URL'sini, kurulumun sonunda 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. Aşağıdakine benzer bir URL görürsünüz. IP adresi, Makine 1'e veya alternatif yapılandırmalar için kullanıcı arayüzünü yüklediğiniz makineye 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 şu biçimde bir URL kullanabilirsiniz:
      http://localhost:9000/login

      Not: 9000 numaralı bağlantı noktasının açık olduğundan emin olun.
    2. Konsol giriş sayfasında Apigee sistem yöneticisi kullanıcı adını/şifresini belirtin.
      Not: Bu, yükleme sırasında ayarladığınız global sistem yöneticisi şifresidir. Alternatif olarak şunları yapabilirsiniz:
  5. Yeni bir Apigee kullanıcı hesabı oluşturun ve giriş yapmak için yeni kullanıcı kimlik bilgilerini kullanın.
    1. Sign In'i (Oturum Aç) tıklayın. Tarayıcı şu adrese yönlendirilir:
      http://192.168.56.111:9000/platform/#/<orgname>/

      ve daha önce oluşturulan kuruluşu yapılandırmanıza olanak tanıyan bir kontrol paneli açılır (Apigee yönetici kimlik bilgileri kullanılarak giriş yapıldıysa).
    2. Edge'i ilk kez kullanıyorsanız artık ilk API proxy'nizi oluşturabilirsiniz. Daha fazla bilgi için İlk API proxy'nizi oluşturma başlıklı makaleyi inceleyin.

      Ayrıca Örnekler listesi dahil olmak üzere örneklerle ilgili bölümleri ve kendi API oluşturma denemelerinizde kullanabileceğiniz sahte hedef RESTful API'leri için Sahte Hedef API'si bölümünü inceleyin.