Kuruluş, ortam ve sanal ana makine oluşturma

Tek bir komut satırında bir kuruluş, ortam ve sanal ana makine oluşturabilirsiniz. komutunu kullanabilir veya her birini ayrı ayrı oluşturabilirsiniz. Ayrıca, Edge API'si bu işlemlerin çoğunu gerçekleştirebilirsiniz.

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

Bir kuruluş oluştururken, sanal ana makineyi aynı anda kullanıyor

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

Genellikle kuruluşlar ve ortamlar birlikte oluşturulur. Süreci basitleştirmek için apigee-provision yardımcı programı. Edge Management'taki komut satırından çağırın Sunucu:

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

Burada configFile, takip etmek için:

# 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ı, bir kuruluş oluştururken şunları yapar:

  • Kuruluşu oluşturur.
  • Kuruluşu "ağ geçidi" ile ilişkilendirir kapsülü. 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 İşleyicileri ile ilişkilendirir.
  • Analizleri etkinleştirir.

Varsayılan olarak, kuruluş adı ve ortam adının maksimum uzunluğu 20 karakterdir apigee-provision yardımcı programını kullanırken dikkatli olun. Bu sınır, Kuruluşu veya ortamı doğrudan oluşturmak için Edge API'yi kullanın. Hem kuruluş adı hem de ortam ad küçük harfle yazılmalıdır.

Kuruluş oluşturma

Kuruluş oluşturmak için aşağıdaki örnekte create-org komutunu kullanın. gösterir:

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

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

Yapılandırma dosyası, kuruluşun adını ve e-posta adresini içerir yöneticiyim. name özelliğinde kullanabileceğiniz karakterler şununla sınırlıdır: a-z0-9\-$%. 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 "ağ geçidi" ile ilişkilendirir kapsülü.
  • Belirtilen kullanıcıyı kuruluş yöneticisi olarak ekler. Kullanıcı zaten mevcut olmalıdır; Aksi takdirde komut dosyası bir hata verir.
ziyaret edin.

Şu hesabı kullanarak bir kuruluş oluşturun: API çağrıları

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

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ıyı oluşturmak için aşağıdaki çağrıyı kullanabilirsiniz: Kullanıcı ekleme.

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 makineyi oluşturmak için barındırıcı:

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ı dahil eden bir kurumla ilgilidir.
  • Analizleri etkinleştirir

Bir ortam oluşturmak için API çağrıları

Alternatif olarak, ortam oluşturmak için aşağıdaki API çağrılarını kullanabilirsiniz. İlk arama 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 İşleyen ile ilişkilendirir. Her biri için bu aramayı yap Ortamla ilişkilendirmek istediğiniz Mesaj İşleyici:

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"

Burada uuid, İleti İşleyen'in UUID'sidir. UUID'yi komut:

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

Burada Message_Processor_IP, İleti İşleyen'in IP adresidir.

Bir sonraki API çağrısı, belirli bir ortam için Analytics'i etkinleştirir. Doğrulama yöntemi, Tüm veri merkezlerinin kapsüllerinde Qpid ve Postgres Sunucuları. Ardından Analytics'e ilk katılım adımı belirleniyor.

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 aşağıdakini 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 özelliği 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 çıkışı bir JSON nesnesidir. Her Qpid sunucusu için çıkış göreceksiniz: form:

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

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

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

Her Postgres sunucusu için şu biçimde çı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. Genellikle birden fazla sanal ana makineyi destekler. Örneğin, bir sanal ana makine, protokolü kullanılırken aynı ortamdaki başka bir sanal ana makine şifrelenmiş HTTPS'yi destekler protokolü.

Ek sanal ana makineler oluşturmak veya sanal ana makine olmayan bir ortamda

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

Güvenli bir sanal makine oluşturma dahil olmak üzere sanal ana makine oluşturma hakkında eksiksiz bir açıklama için HTTPS üzerinden TLS/SSL kullanan bir ana makine görmek için API'ye TLS erişimini yapılandırma .