Kuruluş, ortam ve sanal ana makine oluşturma

Private Cloud için Edge v4.18.05

Komut satırında tek bir komutla kuruluş, ortam ve sanal ana makine oluşturabilir veya her birini ayrı ayrı oluşturabilirsiniz. Ayrıca, bu işlemlerin çoğunu gerçekleştirmek için yönetim API'sini de kullanabilirsiniz.

Video: Apigee kuruluşunun kurulumu ve yapılandırmasına genel bakış için kısa bir video izleyin.

Aynı anda kuruluş, ortam ve sanal ana makine oluşturma

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

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

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

Burada configFile, aşağıdakine benzer bir yapılandırma dosyasının yoludur:

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.
NEW_USER="y"
USER_NAME=orgAdmin@myCo.com
FIRST_NAME=foo
LAST_NAME=bar
USER_PWD="userPword"
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod  # lowercase only
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.
# Optionally set the base URL displayed by the Edge UI for an
# API proxy deployed to the virtual host.
# VHOST_BASEURL="http://myCo.com"
# AXGROUP=axgroup-001 # Default value is axgroup-001

setup-org komut dosyası, kuruluş oluştururken aşağıdakileri yapar:

  • Kuruluşu oluşturur.
  • Kuruluşu "geçiş noktası" kapsülüyle ilişkilendirir. Bu ayarı değiştiremezsiniz.
  • Belirtilen kullanıcıyı kuruluş yöneticisi olarak ekler. Kullanıcı yoksa oluşturabilirsiniz.
  • Bir veya daha fazla ortam oluşturur.
  • Her ortam için bir veya daha fazla sanal ana makine oluşturur.
  • Ortamı tüm Mesaj İşleyicilerle ilişkilendirir.
  • Analizleri etkinleştirir.

apigee-provision yardımcı programı kullanılırken kuruluş adı ve ortam adının varsayılan maksimum uzunluğu 20 karakterdir. Kuruluşu veya ortamı doğrudan Edge API'yi kullanarak oluşturursanız bu sınır geçerli olmaz.

Kuruluş oluşturma

Aşağıdaki örnekte gösterildiği gibi, 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 kuruluşun API çağrılarını işlemesi için gereken ortamları ve sanal ana makineleri eklemez ya da yapılandırmaz.

Yapılandırma dosyası, kuruluşun adını ve kuruluş yöneticisinin e-posta adresini içerir. name ö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=admin_password  # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ORG_ADMIN=orgAdmin@myCo.com

create-org komut dosyası:

  • Kuruluşu oluşturur.
  • Kuruluşu "gateway" kapsülüyle ilişkilendirir.
  • Belirtilen kullanıcıyı kuruluş yöneticisi olarak ekler. Kullanıcının zaten mevcut olması gerekir. Aksi takdirde komut dosyası hata verir.

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

Kuruluş oluşturmak için aşağıdaki API çağrılarını kullanabilirsiniz. İlk çağrıda kuruluş oluşturulur:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_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://management_server_IP:8080/v1/organizations/org_name/pods \
  -d "region=default&pod=gateway"

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

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ı ekleme bölümünde açıklandığı gibi kullanıcıyı oluşturmak için aşağıdaki çağrıyı kullanabilirsiniz.

Ortam oluşturma

Mevcut bir kuruluşta ortam oluşturmak için add-env komut dosyasını 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=admin_password  # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod  # lowercase only
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. 
# Optionally set the base URL displayed by the Edge UI for an
# API proxy deployed to the virtual host.
# VHOST_BASEURL="http://myCo.com"
# AXGROUP=axgroup-001 # Default value is axgroup-001

add-env komutu:

  • Ortamı oluşturur.
  • Ortam için tek bir sanal ana makine oluşturur.
  • Ortamı, ortamı içeren kuruluşla ilişkili kapsülün içindeki tüm Mesaj İşleyicilerle ilişkilendirir.
  • Analizleri etkinleştirir

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

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

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

Sonraki çağrı, ortamı bir Mesaj İş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://management_server_IP:8080/v1/organizations/org_name/environments/env_name/servers \
  -d "action=add&uuid=uuid"

Buradaki uuid, Mesaj İşleyici'nin UUID'sidir. Aşağıdaki komutu kullanarak UUID'yi edinebilirsiniz:

curl http://Message_Processor_IP:8082/v1/servers/self

Buradaki Message_Processor_IP, Mesaj İşleyici'nin IP adresidir.

Sonraki API çağrısı, Analytics'i belirli bir ortam için etkinleştirir. Tüm veri merkezlerinin POD'larında Qpid ve Postgres sunucularının varlığını doğrular. Ardından, belirli kuruluş ve ortam için Analytics oryantasyon sürecini başlatır.

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

ORG_NAME=orgName  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=envName  # lowercase only

sample.json dosyası ş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 mülkü, Postgres UUID'lerinin virgülle ayrılmış bir listesini, qpid-server mülkü ise Qpid UUID'lerini içerir. Bu UUID'leri almanız gerekiyorsa aşağıdaki komutları kullanın.

Qpid için aşağıdaki komutu çalıştırın:

curl -u sysAdminEmail:password http://management_server_IP/v1/servers?pod=central

Bu komutun çıktısı bir JSON nesnesi olur. Her Qpid sunucusu için aşağıdaki biçimde çıkış görürsünüz:

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

Postgres için aşağıdaki komutu çalıştırın:

curl -u sysAdminEmail:passwor http://management_server_IP/v1/servers?pod=analytics

Her Postgres sunucusu için aşağıdaki biçimde bir çıkış 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. Çoğu zaman bir ortam 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 makine oluşturmak veya sanal ana makinesi olmayan bir ortam için sanal ana makine oluşturmak üzere aşağıdaki API çağrısını kullanın:

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

HTTPS üzerinden TLS/SSL kullanan güvenli bir sanal ana makine oluşturma dahil olmak üzere sanal ana makine oluşturma hakkında tam açıklama için Private Cloud için bir API'ye TLS erişimini yapılandırma başlıklı makaleyi inceleyin.