Edge for Private Cloud sürüm 4.17.05
Edge yönetim API'sine çağrı yaparak gerçekleştirdiğiniz Edge yapılandırma görevlerini gerçekleştirmek için apigee-adminapi.sh yardımcı programını kullanın. apigee-adminapi.sh yardımcı programının avantajı şunlardır:
- Basit bir komut satırı arayüzü kullanma
- Sekmeye dayalı komut tamamlamayı uygular.
- Yardım ve kullanım bilgileri sağlar.
- API'yi denemeye karar verirseniz ilgili API çağrısını gösterebilir.
apigee-adminapi.sh yardımcı programı, apigee-provision yardımcı programının yerine geçmez. apigee-provision yardımcı programı, görevlerini gerçekleştirmek için aslında apigee-adminapi.sh yardımcı programını kullanır.
İkisi arasındaki temel farklar şunlardır:
- apigee-adminapi.sh yardımcı programı, bağımsız Edge API çağrılarının yerini alan atomik işlevler gerçekleştirir. Örneğin, bir kuruluş, ortam ve sanal ana makine oluşturmak için üç API çağrısına karşılık gelen üç ayrı apigee-adminapi.sh komutu gerekir.
- apigee-provision yardımcı programı, tek bir komutla eksiksiz bir üst düzey işlem gerçekleştirmek için tasarlanmıştır. Örneğin, gerekli tüm bilgileri içeren bir yapılandırma dosyası ileterek tek bir apigee-provision komutuyla kuruluş, ortam ve sanal ana makine oluşturabilirsiniz.
Edge belgelerinde, uygun olan yerlerde her iki yardımcı program da kullanılır.
apigee-adminapi.sh yükleniyor
apigee-adminapi.sh yardımcı programı, apigee-provision veya apigee-validate yardımcı programını yüklediğinizde otomatik olarak yüklenir.
Yardımcı program aşağıdaki konuma yüklenir:
/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh
apigee-adminapi.sh söz dizimi
apigee-adminapi.sh yardımcı programı, basit bir komut satırı söz dizimi kullanır. Kullanılabilir komut seçeneklerini listeleyen bir istem görüntülemek için istediğiniz zaman sekme tuşunu kullanın.
Olası tüm komutları görmek için yardımcı programı herhangi bir seçenek olmadan çağırın:
> apigee-adminapi.sh
apigee-adminapi.sh yazdıktan sonra sekme tuşuna basarsanız olası seçeneklerin listesini görürsünüz:
analytics classification logsessions regions securityprofile userroles buildinfo GET orgs runtime servers users
Sekme tuşu, komutun bağlamına göre seçenekleri gösterir. Yazdıktan sonra sekme tuşuna basarsanız:
> apigee-adminapi.sh orgs
orgs komutunu tamamlamak için kullanabileceğiniz seçenekleri görürsünüz:
add apis apps delete envs list pods userroles
Herhangi bir komutla ilgili yardım almak için -h seçeneğini kullanın. Örneğin, -h seçeneğini aşağıda gösterildiği gibi kullanırsanız:
> apigee-adminapi.sh orgs -h
Yardımcı program, orgs komutu için tüm olası seçeneklerle ilgili eksiksiz yardım bilgilerini gösterir. Çıktıdaki ilk öğe, "orgs add" komutuyla ilgili yardım bilgisini gösterir:
+++++++++++++++++++++++++++++++++++++++++++ orgs add Required: -o ORG Organization name Optional: -H HEADER add http header in request --admin ADMIN_EMAIL admin email address --pwd ADMIN_PASSWORD admin password --host EDGE_SERVER edge server to make request to --port EDGE_PORT port to use for the http request --ssl set EDGE_PROTO to https, defaults to http --debug ( set in debug mode, turns on verbose in curl ) -h Displays Help
Komut satırı anahtarlarını ve ortam değişkenlerini kullanarak parametreleri ayarlama
Bir komutun tüm parametrelerini komut satırı anahtarlarını veya ortam değişkenlerini kullanarak girmeniz gerekir. Komut satırı anahtarlarının önüne gerektiği gibi tek tire (-) veya çift tire (--) ekleyin.
Örneğin, "orgs add" komutu için yukarıda gösterilen yardımda, kuruluş adını şu yöntemlerden biriyle belirtebilirsiniz:
- -o komut satırı anahtarını kullanarak:
> apigee-adminapi.sh orgs -o testOrg - ORG adlı bir ortam değişkeni ayarlama:
> export ORG=testOrg
> apigee-adminapi.sh orgs
Komut için gerekli parametrelerden herhangi birini atlarsanız yardımcı program, eksik parametreleri açıklayan bir hata mesajı gösterir. Örneğin, bir kuruluş oluştururken Edge Yönetim Sunucusu'nu belirten --host veya EDGE_SERVER ortam değişkenini atlarsanız aşağıdaki hata mesajını görürsünüz:
Error with required variable or parameter ADMIN_PASSWORD....OK ADMIN_EMAIL....OK EDGE_SERVER....null
Genellikle ortam değişkenleri olarak ayarladığınız iki yaygın parametre, sistem yöneticisi e-posta adresi ve Yönetim Sunucusu'nun IP adresidir:
> export ADMIN_EMAIL=foo@bar.com > export EDGE_SERVER=192.168.56.101
apigee-adminapi.sh yardımcı programına dosya iletme
Bazı apigee-adminapi.sh yardımcı program komutları, istek gövdesi alan PUT ve POST API çağrılarına karşılık gelir. Örneğin, sanal ana makine oluşturmak, istek gövdesinde sanal ana makine hakkında bilgi gerektiren bir POST API çağrısına karşılık gelir.
Sanal ana makine oluşturmak için apigee-adminapi.sh yardımcı programını veya istek gövdesi alan herhangi bir komutu kullanırken gerekli tüm bilgileri komut satırında aşağıdaki gibi iletebilirsiniz:
> apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -v myVHostUtil -p 9005 -a 192.168.56.101:9005
Alternatif olarak, POST'un istek gövdesinde yer alacak bilgileri içeren bir dosya da iletebilirsiniz. Örneğin, aşağıdaki komut sanal ana makineyi tanımlayan bir dosya alır:
> apigee-adminapi.sh orgs envs virtual_hosts add -e prod -o testOrg --host localhost --admin foo@bar.com -f vhostcreate
Burada vhostcreate dosyası, çağrının POST gövdesini içerir. Bu örnekte, XML biçimli bir istek gövdesi kullanılmıştır:
<VirtualHost name="myVHostUtil">
<HostAliases>
<HostAlias>192.168.56.101:9005</HostAlias>
</HostAliases>
<Interfaces/>
<Port>9005</Port>
</VirtualHost>Hata ayıklama ve API bilgilerini görüntüleme
Komutla ilgili ayrıntılı bilgileri görüntülemek için apigee-adminapi.sh yardımcı programında --debug seçeneğini kullanın. Bu bilgiler, işlemi gerçekleştirmek için apigee-adminapi.sh yardımcı programı tarafından oluşturulan cURL komutunu içerir.
Örneğin, bu komut --debug seçeneğini kullanır:
> apigee-adminapi.sh orgs add -o testOrg2 --admin foo@bar.com --host localhost --debug
Oluşturulan cURL komutu da dahil olmak üzere aşağıdaki çıkışı gösterir:
curl -H Content-Type: application/xml -v -X POST -s -k -w \n==> %{http_code} -u ***oo@bar.com:***** http://localhost:8080/v1/o -d <Organization name="testOrg2" type="paid"/> * About to connect() to localhost port 8080 (#0) * Trying ::1... connected * Connected to localhost (::1) port 8080 (#0) * Server auth using Basic with user 'foo@bar.com' > POST /v1/o HTTP/1.1 > Authorization: Basic c2dp234234NvbkBhcGlnZ2342342342342341Q5 > User-Agent: curl/7.19.7 (x86_64-redhat-linux-gnu) libcurl/7.19.7 NSS/3.19.1 Basic ECC zlib/1.2.3 libidn/1.18 libssh2/1.4.2 > Host: localhost:8080 > Accept: */* > Content-Type: application/xml > Content-Length: 43 > } [data not shown] < HTTP/1.1 201 Created < Content-Type: application/json < Date: Tue, 03 May 2016 02:08:32 GMT < Content-Length: 291 < { [data not shown] * Connection #0 to host localhost left intact * Closing connection #0