Kuruluş, Ortam ve Sanal Ana Makine Oluşturma

Edge for Private Cloud v. 4.17.01

Aynı anda Kuruluş, Ortam ve Sanal Ana Makine oluşturma

Apigee Edge'de API proxy'si oluşturmadan önce en az bir kuruluş ve her kuruluş içinde bir veya daha fazla ortam ile sanal ana makine oluşturmanız gerekir.

Genellikle kuruluşlar ve ortamlar birlikte oluşturulur. Süreci basitleştirmek için Apigee-provide yardımcı programını kullanın. Uç Yönetim Sunucusu'nda komut satırından çağırın:

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

Yapılandırma dosyası şunları içerir:

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=adminPword     # If omitted, you are prompted for it.
NEW_USER="y"
USER_NAME=orgAdmin@myCo.com
FIRST_NAME=foo
LAST_NAME=bar
USER_PWD="userPwrod"
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1: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. 
# AXGROUP=axgroup-001 # Default value is axgroup-001 

Bu durumda komut:

  • Kuruluşu oluşturma
    Not: Bir kuruluşu oluşturduktan sonra yeniden adlandıramazsınız.
  • Kuruluşu bir kapsülle ilişkilendirin. Varsayılan olarak kuruluş, "ağ geçidi" kapsülüyle ilişkilendirilir.
  • Belirtilen kullanıcıyı kuruluş yöneticisi olarak ekleyin. Kullanıcı yoksa oluşturabilirsiniz.
  • Bir veya daha fazla ortam oluşturma
  • Her ortam için bir veya daha fazla sanal ana makine oluşturma
  • Ortamı tüm Mesaj İşleyicileriyle ilişkilendirme
  • Analizi etkinleştir

Sessiz yapılandırma dosyasının tamamı için Kuruluşa katılma konusuna bakın.

Varsayılan olarak, Apigee-renew yardımcı programı kullanılırken kuruluş adı ve ortam adının maksimum uzunluğu 20 karakterdir. Kuruluş veya ortamı oluşturmak için doğrudan Edge API'yi kullanıyorsanız bu sınır geçerli değildir.

Kuruluş Oluşturun

Kuruluş oluşturmak için create-org komutunu kullanın:

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

Bu komut dosyası, kuruluşu oluşturur ancak API çağrılarını işlemek için kuruluşun ihtiyaç duyduğu ortamları ve sanal ana makineleri eklemez veya yapılandırmaz.

Yapılandırma dosyası, kuruluşun adını ve kuruluş yöneticisinin e-posta adresini içerir. Ad özelliğinde kullanabileceğiniz karakterler a-z0-9\-$% ile sınırlıdır. Adda boşluk, nokta veya büyük harf kullanmayın:

APIGEE_ADMINPW=adminPword    # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ORG_ADMIN=orgAdmin@myCo.com

Bu durumda komut:

  • Kuruluşu oluşturur
  • Kuruluşu bir kapsülle ilişkilendirir. Varsayılan olarak kuruluş, "ağ geçidi" kapsülüyle ilişkilendirilir.
  • Belirtilen kullanıcıyı kuruluş yöneticisi olarak ekler. Kullanıcının zaten mevcut olması gerekir. Aksi takdirde komut dosyası hata verir.
<Error>
    <Code>organizations.OrganizationAlreadyExists</Code>
    <Message>Organization : test already exists</Message>
    <Contexts/>
</Error>

API çağrılarını kullanarak kuruluş oluşturun

Alternatif olarak, kuruluş oluşturmak için aşağıdaki API çağrılarını kullanabilirsiniz. İlk çağrı, kuruluşu oluşturur:

curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<adminPasswd> \
-X POST http://<ms-ip>:8080/v1/organizations \
-d '<Organization name="<org-name>" type="paid"/>'

Sonraki çağrı, kuruluşu bir kapsülle ilişkilendirir:

curl -H "Content-Type:application/x-www-form-urlencoded" \
-u <sysAdminEmail>:<adminPasswd> -X POST \
http://<ms-ip>:8080/v1/organizations/<org-name>/pods \
-d "region=default&pod=gateway" 

Kuruluşu birden fazla kapsülle ilişkilendirmek için bu çağrıyı birden çok kez yapabilirsiniz.

Son çağrı, mevcut bir kullanıcıyı kuruluşun kuruluş yöneticisi olarak ekler:

curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<adminPasswd> \
-X POST \
http://<ms-ip>:8080/v1/organizations/<org-name>/users/<user-email>/userroles/ \
-d '<Roles><Role name="orgadmin"/></Roles>'

Kullanıcı mevcut değilse kullanıcıyı oluşturmak için Kullanıcı ekleme bölümünde açıklandığı şekilde aşağıdaki çağrıyı kullanabilirsiniz.

Ortam Oluşturma

Mevcut bir kuruluşta bir ortam oluşturmak için add-env komutunu kullanın:

> /opt/apigee/apigee-service/bin/apigee-service apigee-provision add-env -f configFile

Bu yapılandırma dosyası, ortamı ve sanal ana makineyi oluşturmak için gereken bilgileri içerir:

APIGEE_ADMINPW=adminPword    # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1: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. 
# AXGROUP=axgroup-001 # Default value is axgroup-001

Komut:

  • Ortamı oluşturur
  • Ortam için tek bir sanal ana makine oluşturur
  • Ortamı, ortamı içeren kuruluşla ilişkili kapsüldeki tüm Mesaj İşleyicileri ile ilişkilendirir.
  • Analizi etkinleştirir
    Not: Kuruluştaki bir ortam için analizi etkinleştirirseniz kuruluştaki tüm ortamlar için analizi etkinleştirmeniz gerekir.

API çağrılarını kullanarak ortam oluşturun

Alternatif olarak, bir ortam oluşturmak için aşağıdaki API çağrılarını kullanabilirsiniz. İlk çağrı ortamı oluşturur:

curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<adminPasswd> \
-X POST http://<ms-ip>:8080/v1/organizations/<org-name>/environments \
-d  '<Environment name="<env-name>"/>' 

Sonraki çağrı, ortamı bir İleti İşleyici ile ilişkilendirir. Ortamla ilişkilendirmek istediğiniz her Mesaj İşleyici için bu çağrıyı yapın:

curl -H "Content-Type:application/x-www-form-urlencoded" \
-u <sysAdminEmail>:<adminPasswd> -X POST \
http://<ms-ip>:8080/v1/organizations/<org-name>/environments/<env-name>/servers \
-d "action=add&uuid=<uuid>"

Burada "<uuid>", Mesaj İşleyici'nin UUID'sidir. UUID'yi şu komutu kullanarak alabilirsiniz:

> curl http://<mp-ip>:8082/v1/servers/self

Buradaki "<mp-ip>", Mesaj İşleyici'nin IP adresidir.

Bir sonraki API çağrısı, belirli bir ortam için Analytics'i etkinleştirir. Tüm veri merkezlerinin POD'larında Qpid ve Postgres Sunucularının varlığını doğrular. Ardından, ilgili kuruluş ve ortam için Analytics'e ilk katılım süreci başlar.

> /opt/apigee/apigee-service/bin/apigee-service apigee-provision enable-ax -f configFile

Bu yapılandırma dosyası şunları içerir:

ORG_NAME=orgName  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=envName
curl -H "Content-Type:application/json" -u <sysAdminEmail>:<adminPasswd> 
-X POST http://<ms-ip>:8080/v1/organizations/<org-name>/environments/<env-name>/analytics/admin -d "@sample.json"

example.json şunları içerir:

{
  "properties" : {
    "samplingAlgo" : "reservoir_sampler",
    "samplingTables" : "10=ten;1=one;",
    "aggregationinterval" : "300000",
    "samplingInterval" : "300000",
    "useSampling" : "100",
    "samplingThreshold" : "100000"
  },
  "servers" : {
    "postgres-server" : [ "1acff3a5-8a6a-4097-8d26-d0886853239c", "f93367f7-edc8-4d55-92c1-2fba61ccc4ab" ],  
    "qpid-server" : [ "d3c5acf0-f88a-478e-948d-6f3094f12e3b", "74f67bf2-86b2-44b7-a3d9-41ff117475dd"] 
  }
}

postgres-servers özelliği Postgres UUID'lerinin virgülle ayrılmış listesini içerir ve qpid-server özelliği Qpid UUID'lerini içerir. Bu UUID'leri almanız gerekiyorsa aşağıdaki komutları kullanın.

Qpid için şu komutu çalıştırın:

curl -u <sysAdminEmail>:<passwd> http://<ms-ip>/v1/servers?pod=central

Bu komutun çıkışı bir JSON nesnesidir. Her Qpid sunucusu için şu biçimde çıktı görürsünüz:

"type" : [ "qpid-server" ],
"uUID" : "d3c5acf0-f88a-478e-948d-6f3094f12e3b"

Postgres için şu komutu çalıştırın:

curl -u <sysAdminEmail>:<passwd> http://<ms-ip>/v1/servers?pod=analytics

Her Postgres sunucusu için şu biçimde çıktı görürsünüz:

"type" : [ "postgres-server" ],
"uUID" : "d3c5acf0-f88a-478e-948d-6f3094f12e3b"

Sanal Ana Makine Oluşturma

Bir kuruluştaki mevcut bir ortamda sanal ana makine oluşturabilirsiniz. Bir ortam genellikle birden fazla sanal ana makineyi destekler. Örneğin, bir sanal ana makine HTTP protokolünü desteklerken aynı ortamdaki başka bir sanal ana makine şifrelenmiş HTTPS protokolünü destekleyebilir.

Ek sanal ana makineler oluşturmak veya sanal ana makine bulunmayan bir ortam için sanal ana makine oluşturmak için aşağıdaki API çağrısını kullanın:

curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<adminPasswd> \
-X POST \
http://<ms-ip>:8080/v1/organizations/<org-name>/environments/<env-name>/virtualhosts \
-d '<VirtualHost name="default"> \
    <HostAliases> \
      <HostAlias>myorg-test.apigee.net</HostAlias> \ 
    </HostAliases> \
    <Interfaces/> \
    <Port>9002</Port> \
  </VirtualHost>' 

HTTPS üzerinden TLS/SSL kullanan güvenli bir sanal ana makine oluşturma dahil olmak üzere sanal ana makine oluşturma ile ilgili kapsamlı bir açıklama için http://apigee.com/docs/api-services/content/creating-virtual-host adresine bakın.