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

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Z tego artykułu dowiesz się, jak wdrożyć serwer proxy z poziomu wiersza poleceń. Apigee Edge zapewnia 2 funkcje z dostępnymi opcjami wdrażania z poziomu wiersza poleceń. Pierwszą z nich jest użycie narzędzia do wdrażania Apigee Edge napisane w Pythonie. Drugim sposobem jest skonfigurowanie i uruchomienie skryptu powłoki.

Jeśli pracujesz bezpośrednio ze źródłem serwera proxy, używaj technik wdrażania z wiersza poleceń. pliki w systemie. Jest wiele powodów, dla których możesz pracować w trybie offline. Możesz użyć rozszerzenia ulubiony edytor XML lub tworzysz zasady wymagające kodowania w języku Java, a Ty nie masz uprawnień, które działają głównie w IDE. Techniki opisane w tej sekcji umożliwiają przesyłanie wdrożyć pliki źródłowe w wybranym środowisku usług API.

Jeśli pracujesz głównie w interfejsie zarządzania, zapoznaj się z artykułem Wdrażanie serwerów proxy w interfejsie.

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, aby importować i wdrażać interfejs API serwerów proxy. Narzędzie jest dostępne w ramach dystrybucji przykładowych platform API na GitHubie. Zobacz Korzystanie z przykładowych serwerów proxy interfejsu API

Za pomocą narzędzia Apigee Edge Python możesz w prosty sposób importować (przesyłać) i wdrażać interfejs API proces tworzenia konta.

Narzędzie do wdrażania musi być uruchamiane w katalogu podstawowym w dystrybucji platformy API Rozkład przykładów, w którym katalog podstawowy jest katalogiem nadrzędnym instancji setup i tools.

W poniższym poleceniu zastąp nazwę serwera proxy, nazwę użytkownika i hasło do Edge organizacji i środowiska oraz ścieżkę do katalogu zawierającego "Katalog apiproxy":

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, wypycha je do organizacji w Apigee Edge i wdraża do określonego środowiska.

Narzędzie do wdrażania automatycznie wykrywa bieżącą wersję interfejsu API serwera proxy, wycofanie wdrożenia istniejącej wersji i wdrożenie przyrostowej wersji interfejsu API serwera proxy.

Kiedy operacja się uda, wyświetli się wynik w tym formacie:

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 https://api.enterprise.apigee.com, odpowiadając Edge w chmurze. Za pomocą tego narzędzia można także przesłać serwer proxy interfejsu API do lokalną wersję 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 brzegowego. W przypadku utworzenia rekord DNS dla serwera zarządzania, możesz określić adres URL w następującej postaci:

https://ms_URL:8080

Pełna lista flag tego 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 z plikami serwera proxy interfejsu API. Serwer proxy interfejsu API muszą być przechowywane w katalogu o nazwie „apiproxy”. Ta wartość to ścieżka funkcji katalog zawierający parametr „apiproxy” katalogu, a nie ścieżki do parametr „apiproxy” do katalogu.
  • -p: ścieżka identyfikatora URI używana jako dopasowanie do wzorca do kierowania wiadomości przychodzących do tego interfejsu API. wdrożenie serwera proxy. W większości przypadków możesz ustawić tę wartość na „/”, chyba że masz zaawansowane na potrzeby wdrażania i routingu. Ścieżka podstawowa używana do routingu serwera proxy interfejsu API jest zdefiniowana w plik konfiguracji ProxyEndpoint serwera proxy interfejsu API.
  • -h: adres URL krawędzi. Domyślnie jest to https://api.enterprise.apigee.com, odpowiadając Edge w chmurze. W przypadku wdrożenia lokalnego użyj adresu URL Edge serwer zarządzania i port 8080, na przykład: 
    https://ms_URL:8080

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

Konfigurowanie i uruchamianie powłoki wdrożenia pismo

Najprostszym sposobem jest uruchomienie skryptu wdrażania dostępnego w przykładowym serwerze proxy interfejsu API. Powłoka opakowują narzędzie do wdrażania Apigee Edge Python.

Po uruchomieniu 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 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, że musisz zmodyfikować plik /setup/setenv.sh w dystrybucji próbek na platformie. Instrukcje znajdziesz w pliku README lub w artykule Apigee Edge API.

Po udanym wdrożeniu narzędzie do wdrażania kompresuje pliki w /apiproxy, importach pakiet do Twojej organizacji w Apigee Edge, a następnie wdrożysz serwer proxy interfejsu API w „teście” dla środowiska.

Serwer proxy interfejsu API jest gotowy do wywołania.