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

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Z tego artykułu dowiesz się, jak wdrożyć proxy z wiersza poleceń. Apigee Edge oferuje 2 opcje wdrażania z wiersza poleceń. Pierwsza to użycie narzędzia do wdrażania Apigee Edge napisanego w Pythonie. Druga to skonfigurowanie i uruchomienie skryptu powłoki.

Używaj metod wdrażania z wiersza poleceń, gdy pracujesz bezpośrednio z plikami źródłowymi proxy w systemie. Istnieje wiele powodów, dla których możesz pracować offline. Możesz chcieć użyć ulubionego edytora XML lub tworzyć zasady, które wymagają kodowania w języku Java, i pracować głównie w IDE. Metody 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, przeczytaj artykuł Wdrażanie proxy w interfejsie.

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X. info

Uruchamianie narzędzia do wdrażania Apigee Edge w Pythonie

Narzędzie do wdrażania Apigee Edge w Pythonie współpracuje z interfejsem Edge Management API, aby importować i wdrażać proxy interfejsów API. Narzędzie jest dostępne w ramach dystrybucji przykładowych interfejsów API na GitHubie. Zobacz Korzystanie z przykładowych proxy interfejsów 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 musi być uruchamiane z katalogu głównego w dystrybucji przykładowych interfejsów API, gdzie katalog główny jest katalogiem nadrzędnym katalogów setup i tools.

W poniższym poleceniu zastąp nazwę proxy, nazwę użytkownika i hasło Edge, organizację i środowisko Edge oraz ścieżkę do katalogu zawierającego katalog „apiproxy"” 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 spakuje pliki, prześle je do Twojej organizacji w Apigee Edge i wdroży w określonym środowisku.

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

W przypadku powodzenia zobaczysz dane wyjściowe w postaci:

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 proxy interfejsu API na adres https://api.enterprise.apigee.com, który odpowiada Edge w chmurze. Możesz też użyć tego narzędzia, aby przesłać proxy interfejsu API do lokalnej wersji Edge, określając flagę -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 określasz adres IP serwera zarządzania Edge. Jeśli masz rekord DNS serwera zarządzania, możesz określić adres URL w takiej postaci:

https://ms_URL:8080

Pełna lista flag polecenia:

  • -n: nazwa 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 ma zostać wdrożone proxy interfejsu API (test lub prod).
  • -d: ścieżka do katalogu zawierającego pliki proxy interfejsu API. Pliki proxy interfejsu API muszą być przechowywane w katalogu o nazwie „apiproxy”. Ta wartość to ścieżka do katalogu zawierającego katalog "apiproxy", a nie ścieżka do samego katalogu "apiproxy".
  • -p: ścieżka identyfikatora URI używana jako wzorzec do kierowania wiadomości przychodzących do tego wdrożenia 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. Główna ścieżka używana do routingu proxy interfejsu API jest zdefiniowana w pliku konfiguracyjnym ProxyEndpoint proxy interfejsu API.
  • -h: adres URL Edge. Domyślnie adres URL to https://api.enterprise.apigee.com, odpowiadający Edge w chmurze. W przypadku wdrożenia lokalnego użyj adresu URL serwera zarządzania Edge i portu 8080, np.: 
    https://ms_URL:8080

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

Konfigurowanie i uruchamianie skryptu powłoki wdrażania

Najprościej jest uruchomić skrypt wdrażania dostarczony z przykładowym proxy interfejsu API. Skrypty powłoki opakowują narzędzie do wdrażania Apigee Edge w Pythonie.

W katalogu /simplyProxy uruchom:

$ sh deploy.sh

Zobaczysz:

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

Wpisz hasło i naciśnij ENTER.

Następnie zobaczysz:

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

Jeśli zobaczysz:

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ładowych interfejsów API. Instrukcje znajdziesz w pliku README lub w dokumentacji interfejsów API Apigee Edge.

Po pomyślnym zakończeniu narzędzie do wdrażania spakuje pliki w katalogu /apiproxy, zaimportuje pakiet do Twojej organizacji w Apigee Edge, a następnie wdroży proxy interfejsu API w środowisku „test” .

Proxy interfejsu API jest gotowe do wywołania.