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 proxy'nin nasıl dağıtılacağı açıklanmaktadır. Apigee Edge, komut satırından dağıtım için iki seçenek sunar. Birincisi, Python ile yazılmış bir Apigee Edge dağıtım aracını kullanmaktır. Diğeri ise bir kabuk komut dosyasını yapılandırmak ve çalıştırmaktır.

Sisteminizde doğrudan proxy kaynak dosyalarıyla çalışırken komut satırı dağıtım tekniklerini kullanın. Çevrimdışı çalışıyor olmanızın birçok nedeni olabilir. En sevdiğiniz XML düzenleyiciyi kullanmak veya Java kodlaması gerektiren politikalar geliştirmek isteyebilirsiniz. Bu durumda, öncelikle bir IDE'de çalışıyor olursunuz. 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 dağıtma başlıklı makaleyi inceleyin.

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 aracı, GitHub'daki API Platform Samples dağıtımında bulabilirsiniz. Örnek API proxy'lerini kullanma başlıklı makaleyi inceleyin.

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

Dağıtım aracının, API Platform Samples dağıtımındaki temel dizinden çalıştırılması gerekir. Temel dizin, setup ve tools dizininin üst dizinidir.

Aşağıdaki komutta; proxy adını, Edge kullanıcı adınızı ve şifrenizi, Edge kuruluşunu ve ortamını, 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 gönderir ve belirtilen ortama dağıtır.

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

Başarılı olduğunda şu biçimde bir çıkış 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

Araç, API proxy'sini varsayılan olarak buluttaki Edge'e karşılık gelen https://api.enterprise.apigee.com'ya yükler. -h işaretini belirterek API proxy'sini Edge'in şirket içi sürümüne yüklemek için de bu aracı 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 bir DNS kaydı oluşturduysanız aşağıdaki biçimde bir URL belirtebilirsiniz:

https://ms_URL:8080

Komutun işaretlerinin tam listesi şöyledir:

  • -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'si dosyalarınız "apiproxy" adlı bir dizinde depolanmalıdır. Bu değer, "apiproxy" dizinini içeren dizinin yoludur ve "apiproxy" dizininin yolu değildir.
  • -p: Gelen mesajı bu API proxy dağıtımına yönlendirmek için kalıp eşleştirme 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, https://api.enterprise.apigee.com, buluttaki Edge'e karşılık gelir. Şirket içi dağıtım için Edge yönetim sunucusunun URL'sini ve 8080 bağlantı noktasını kullanın. Örneğin: 
    https://ms_URL:8080

    Alternatif olarak, https://192.168.11.111:8080 örneğinde olduğu gibi yönetim sunucusunun IP adresini kullanın.

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

En kolay yaklaşım, örnek API proxy'siyle birlikte 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 şu komutu çalıştırın:

$ 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 tuşuna basın.

Ardından şunları görürsünüz:

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

Aşağıdaki mesajı 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ında /setup/setenv.sh dosyasını değiştirmeniz gerektiği anlamına gelir. Talimatlar için README dosyasına veya Apigee Edge API'leri'ne bakın.

Başarılı olursa dağıtım aracı, /apiproxy, içindeki dosyaları ZIP'ler, 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.