Komut satırından proxy dağıtma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Bu konuda, komut satırından nasıl proxy dağıtılacağı açıklanmaktadır. Apigee Edge, komut satırından dağıtım yapmak için iki seçenek sunar. İlki, Python'da yazılmış bir Apigee Edge dağıtım aracı kullanmaktır. Diğeri ise bir kabuk komut dosyası yapılandırmak ve çalıştırmaktır.

Sisteminizdeki proxy kaynak dosyalarıyla doğrudan çalışırken komut satırı dağıtım tekniklerini kullanın. Çevrimdışı çalışmanın pek çok nedeni olabilir. Sevdiğiniz bir XML düzenleyiciyi kullanmak isteyebilir veya Java kodlaması gerektiren politikalar geliştiriyor olabilirsiniz ve birincil olarak bir IDE üzerinde çalışıyorsanız. Bu bölümde açıklanan teknikler, kaynak dosyalarınızı seçtiğiniz API Hizmetleri ortamına yüklemenize ve dağıtmanıza olanak tanır.

Öncelikle yönetim kullanıcı arayüzünde çalışıyorsanız Kullanıcı arayüzünde proxy'leri dağıtma konusuna bakın.

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Apigee Edge Python dağıtım aracını çalıştırma

Apigee Edge Python dağıtım aracı, API proxy'lerini içe aktarmak ve dağıtmak için Edge Management API ile birlikte çalışır. Bu araç, GitHub'daki API Platformu Örnekleri dağıtımının bir parçası olarak kullanıma sunulmuştur. Örnek API proxy'lerini kullanma bölümüne bakın.

API'nizi basit tek bir işlemle içe (yükleme) ve dağıtmak için Apigee Edge Python aracını kullanın.

Dağıtım aracı, API Platformu Örnekleri dağıtımının dağıtımındaki temel dizinden çalıştırılmalıdır. Burada temel dizin, setup ve tools dizinlerinin üst dizinidir.

Aşağıdaki komutta proxy adını, Edge kullanıcı adınızı ve şifrenizi, Edge kuruluşu ve ortamını ve API proxy'sinin "apiproxy" dizinini içeren dizinin yolunu değiştirin:

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

Örneğin:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

Bu komut dosyalarınızı sıkıştırır, Apigee Edge'de kuruluşunuza aktarır ve belirtilen ortama dağıtır.

Dağıtım aracı, API proxy'nizin mevcut düzeltmesini otomatik olarak keşfeder, mevcut düzeltmenin dağıtımını kaldırır ve API proxy'sinin kademeli bir düzeltmesini dağıtır.

İşlem başarılı olduğunda şu biçimde çıktı görürsünüz:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

Varsayılan olarak araç, buluttaki Edge'e karşılık gelen API proxy'sini https://api.enterprise.apigee.com adresine yükler. Bu aracı, -h işaretini belirterek API proxy'sini Edge'in şirket içi sürümüne yüklemek için de kullanabilirsiniz:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

Bu örnekte, Edge yönetim sunucusunun IP adresini belirtirsiniz. Yönetim sunucusu için DNS kaydı oluşturduysanız URL'yi aşağıdaki biçimde belirtebilirsiniz:

https://ms_URL:8080

Komutun işaretlerinin tam listesi şu şekildedir:

  • -n: API proxy'nizin adı.
  • -u: Apigee Edge'deki bir kuruluştaki hesabınızın kullanıcı adı ve şifresi.
  • -o: Hesabınızın bulunduğu kuruluşun adı.
  • -e: API proxy'sinin dağıtılması gereken ortam (test veya prod).
  • -d: API proxy dosyalarınızı içeren dizinin yolu. API proxy dosyalarınız "apiproxy" adlı bir dizin altında depolanmalıdır. Bu değer, "apiproxy" dizinine giden değil, "apiproxy" dizinini içeren dizinin yoludur.
  • -p: Gelen mesajı bu API proxy dağıtımına yönlendirmek için kalıp eşleşmesi olarak kullanılan URI yolu. Gelişmiş dağıtım ve yönlendirme gereksinimleriniz yoksa çoğu durumda bu değeri "/" olarak ayarlayabilirsiniz. API proxy yönlendirmesi için kullanılan birincil yol, API proxy'sinin ProxyEndpoint yapılandırma dosyasında tanımlanır.
  • -h: Edge URL'si. Varsayılan olarak URL, buluttaki Edge'e karşılık gelen https://api.enterprise.apigee.com şeklindedir. Şirket içi dağıtımlar için aşağıdaki gibi Edge yönetim sunucusu ve bağlantı noktası 8080'in URL'sini kullanın: 
    https://ms_URL:8080

    Alternatif olarak, yönetim sunucusunun IP adresini (https://192.168.11.111:8080 gibi) kullanabilirsiniz.

Dağıtım kabuğu komut dosyasını yapılandırma ve çalıştırma

En kolay yaklaşım, örnek API proxy'si ile sağlanan dağıtım komut dosyasını çalıştırmaktır. Kabuk komut dosyaları, Apigee Edge Python dağıtım aracını sarmalar.

/simplyProxy dizininden çalıştırma:

$ sh deploy.sh

Aşağıdaki bilgileri görürsünüz:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

Şifrenizi girip ENTER'a basın.

Bunu yaptığınızda:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

Aşağıdakileri görürseniz:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

bu, platform örnekleri dağıtımındaki /setup/setenv.sh dosyasını değiştirmeniz gerektiği anlamına gelir. Talimatlar için README veya Apigee Edge API'lerine bakın.

Başarılı bir şekilde dağıtım aracı, /apiproxy, altındaki dosyaları ZIP dosyasına aktarır ve bu paketi Apigee Edge'de kuruluşunuza aktarır ve ardından API proxy'sini "test" ortamına dağıtır.

API proxy'niz çağrılmaya hazır.