Wdrażanie serwerów proxy z poziomu wiersza poleceń

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

W tym temacie objaśniono, jak wdrożyć serwer proxy za pomocą wiersza poleceń. Apigee Edge udostępnia 2 opcje wdrażania z poziomu wiersza poleceń. Pierwszym z nich jest użycie narzędzia do wdrażania Apigee Edge napisanego w Pythonie. Drugi to skonfigurowanie i uruchomienie skryptu powłoki.

Używaj technik wdrażania wiersza poleceń podczas bezpośredniej pracy z plikami źródłowymi serwera proxy w systemie. Praca w trybie offline może mieć wiele przyczyn. Możesz użyć ulubionego edytora XML lub opracowywać zasady, które wymagają kodowania w języku Java i pracujesz głównie w IDE. Techniki opisane w tej sekcji umożliwiają przesyłanie i wdrażanie plików źródłowych w wybranym środowisku usług API.

Jeśli pracujesz głównie w interfejsie zarządzania, zobacz Wdrażanie serwerów proxy w UI.

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. informacje.

Uruchamianie narzędzia do wdrażania Apigee Edge Python

Narzędzie do wdrażania Apigee Edge Python współpracuje z interfejsem Edge Management API przy importowaniu i wdrażaniu serwerów proxy API. Narzędzie jest dostępne w ramach dystrybucji interfejsów API Platform Samples na GitHubie. Zobacz Korzystanie z przykładowych serwerów proxy interfejsu API.

Użyj narzędzia Apigee Edge w Pythonie, aby zaimportować (przesłać) i wdrożyć interfejs API w jednym prostym procesie.

Narzędzie do wdrażania należy uruchamiać z katalogu podstawowego w dystrybucji przykładów usług platformy API, gdzie katalog podstawowy to katalog nadrzędny katalogu setup i tools.

W poniższym poleceniu zastąp nazwę serwera proxy, nazwę użytkownika i hasło Edge, organizację i środowisko Edge oraz ścieżkę do katalogu zawierającego katalog „apiproxy"” serwera proxy interfejsu API:

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

Na przykład:

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

To polecenie kompresuje pliki, przenosi je do organizacji w Apigee Edge i wdraża je w określonym środowisku.

Narzędzie do wdrażania automatycznie wykrywa bieżącą wersję serwera proxy interfejsu API, wycofuje jej wdrożenie i wdraża zwiększoną wersję serwera proxy interfejsu API.

Po pomyślnym zakończeniu zobaczysz dane wyjściowe w formularzu:

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

Domyślnie narzędzie przesyła serwer proxy interfejsu API do usługi https://api.enterprise.apigee.com, odpowiadający kontu Edge w chmurze. Możesz też użyć tego narzędzia, aby przesłać serwer proxy interfejsu API do lokalnej wersji Edge przez określenie flagi -h:

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

W tym przykładzie podajesz adres IP serwera zarządzania brzegiem. Jeśli masz utworzony rekord DNS dla serwera zarządzania, możesz określić adres URL w tej formie:

https://ms_URL:8080

Pełna lista flag polecenia:

  • -n: nazwa serwera proxy interfejsu API.
  • -u: nazwa użytkownika i hasło do konta w organizacji w Apigee Edge.
  • -o: nazwa organizacji, w której masz konto.
  • -e: środowisko, w którym należy wdrożyć serwer proxy interfejsu API (test lub prod).
  • -d: ścieżka do katalogu zawierającego pliki serwera proxy interfejsu API. Pliki serwera proxy interfejsu API muszą być przechowywane w katalogu „apiproxy”. Ta wartość jest ścieżką katalogu zawierającego katalog „apiproxy”, a nie ścieżki do katalogu „apiproxy”.
  • -p: ścieżka identyfikatora URI używana jako dopasowanie do wzorca w celu kierowania wiadomości przychodzących do tego wdrożenia serwera proxy interfejsu API. W większości przypadków możesz ustawić tę wartość na „/”, chyba że masz zaawansowane wymagania dotyczące wdrażania i routingu. Podstawowa ścieżka używana do routingu serwera proxy interfejsu API jest zdefiniowana w pliku konfiguracji ProxyEndpoint na serwerze proxy interfejsu API.
  • -h: adres URL Edge. Domyślnie adres URL to https://api.enterprise.apigee.com, co odpowiada Edge w chmurze. W przypadku wdrożenia lokalnego użyj adresu URL serwera zarządzania brzegowego i portu 8080 na przykład: 
    https://ms_URL:8080

    Możesz też użyć adresu IP serwera zarządzania, tak jak w zasadzie https://192.168.11.111:8080.

Konfigurowanie i uruchamianie skryptu powłoki wdrożenia

Najprostszym sposobem jest uruchomienie skryptu wdrażania udostępnionego z przykładowym serwerem proxy interfejsu API. Skrypty powłoki zawierają narzędzie do wdrażania Apigee Edge Python.

Z poziomu katalogu /simplyProxy:

$ sh deploy.sh

Zobaczysz, że:

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

Wpisz hasło i naciśnij ENTER.

Zobaczysz wtedy:

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

Jeśli widzisz te informacje:

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]:

oznacza to, że musisz zmodyfikować plik /setup/setenv.sh w dystrybucji przykładowej platformy. Instrukcje znajdziesz w README lub w interfejsach API Apigee Edge.

Po pomyślnym zakończeniu narzędzie do wdrażania kompresuje pliki w folderze /apiproxy,, importując pakiet do organizacji w Apigee Edge, a następnie wdrażając serwer proxy interfejsu API w środowisku „testowym”.

Serwer proxy interfejsu API jest gotowy do wywołania.