Proxys über die Befehlszeile bereitstellen

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

In diesem Thema wird erläutert, wie Sie einen Proxy über die Befehlszeile bereitstellen. Apigee Edge bietet zwei Optionen für die Bereitstellung über die Befehlszeile. Die erste ist die Verwendung eines Apigee Edge-Bereitstellungstools die in Python geschrieben wurden. Die andere besteht darin, ein Shell-Skript zu konfigurieren und auszuführen.

Verwenden Sie die Bereitstellungstechniken über die Befehlszeile, wenn Sie direkt mit der Proxy-Quelle arbeiten. auf Ihrem System. Es gibt viele Gründe, warum Sie offline arbeiten können. Vielleicht möchten Sie Ihren bevorzugten XML-Editor verwenden oder Richtlinien entwickeln, die Java-Programmierung erfordern, hauptsächlich in einer IDE. Mit den in diesem Abschnitt beschriebenen Verfahren können Sie Ihre Quelldateien in der von Ihnen ausgewählten API-Dienste-Umgebung bereitstellen.

Wenn Sie hauptsächlich in der Verwaltungsoberfläche arbeiten, lesen Sie Proxys in der UI bereitstellen.

Sie sehen die Apigee Edge-Dokumentation.
Rufen Sie die Apigee X-Dokumentation auf. weitere Informationen

Apigee Edge Python-Bereitstellungstool ausführen

Das Apigee Edge Python-Bereitstellungstool arbeitet mit der Edge Management API zusammen, um die API zu importieren und bereitzustellen Proxys. Das Tool ist als Teil der API Platform Samples-Distribution auf GitHub verfügbar. Weitere Informationen finden Sie unter Beispiel-API-Proxys verwenden

Verwenden Sie das Python-Tool Apigee Edge, um Ihre API in einem einfachen Tool zu importieren (hochzuladen) und bereitzustellen. .

Das Bereitstellungstool muss vom Basisverzeichnis in der Distribution der API-Plattform ausgeführt werden Stichprobenverteilung, wobei das Basisverzeichnis das übergeordnete Verzeichnis von setup ist und das Verzeichnis tools.

Ersetzen Sie im folgenden Befehl den Proxy-Namen, Ihren Edge-Benutzernamen und -Passwort, den Edge- Organisation und Umgebung und der Pfad zum Verzeichnis, das die API-Proxys "apiproxy"-Verzeichnis:

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

Beispiel:

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

Mit diesem Befehl werden Ihre Dateien komprimiert, per Push in Ihre Organisation auf Apigee Edge übertragen und in der angegebenen Umgebung.

Das Bereitstellungstool erkennt automatisch die aktuelle Version Ihrer API Proxy, hebt die Bereitstellung der vorhandenen Version auf und stellt eine inkrementelle Version der API bereit Proxy.

Bei Erfolg wird die Ausgabe in folgendem Format angezeigt:

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

Standardmäßig lädt das Tool den API-Proxy in https://api.enterprise.apigee.com hoch. für Edge in der Cloud. Sie können dieses Tool auch verwenden, um den API-Proxy auf einen lokale Version von Edge durch Angabe des Flags -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

In diesem Beispiel geben Sie die IP-Adresse des Edge-Verwaltungsservers an. Wenn Sie DNS-Eintrag für den Verwaltungsserver haben, können Sie eine URL im folgenden Format angeben:

https://ms_URL:8080

Die vollständige Liste der Flags für den Befehl sieht so aus:

  • -n: Der Name Ihres API-Proxys.
  • -u: Nutzername und Passwort für Ihr Konto in einer Organisation in Apigee Edge
  • -o: Der Name der Organisation, in der Sie ein Konto haben.
  • -e: Die Umgebung, in der der API-Proxy bereitgestellt werden soll. (test oder prod)
  • -d: Der Pfad zum Verzeichnis, das Ihre API-Proxydateien enthält. Ihr API-Proxy -Dateien müssen in einem Verzeichnis namens "apiproxy" gespeichert werden. Dieser Wert ist der Pfad zur Verzeichnis, das "apiproxy" enthält und nicht zum Pfad zu "apiproxy" Verzeichnis selbst.
  • -p: Der URI-Pfad, der als Musterabgleich verwendet wird, um eingehende Nachrichten an diese API weiterzuleiten Proxy-Bereitstellung. In den meisten Fällen können Sie diesen Wert auf "/" setzen, es sei denn, Sie haben erweiterte Bereitstellungs- und Routinganforderungen. Der primäre Pfad für das API-Proxy-Routing ist definiert in ProxyEndpoint-Konfigurationsdatei des API-Proxys.
  • -h: Die Edge-URL. Standardmäßig lautet die URL https://api.enterprise.apigee.com, für Edge in der Cloud. Verwenden Sie für eine lokale Bereitstellung die URL des Edge- Verwaltungsserver und Port 8080, wie in: 
    https://ms_URL:8080

    Alternativ können Sie die IP-Adresse des Verwaltungsservers verwenden, z. B. https://192.168.11.111:8080.

Bereitstellungs-Shell konfigurieren und ausführen Skript

Der einfachste Ansatz besteht darin, das Bereitstellungsskript auszuführen, das mit dem Beispiel-API-Proxy bereitgestellt wird. Die Muschel Skripte verpacken das Apigee Edge-Python-Bereitstellungstool.

Führen Sie im Verzeichnis /simplyProxy folgenden Befehl aus:

$ sh deploy.sh

Hier sollten Sie dies sehen:

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

Geben Sie Ihr Passwort ein und drücken Sie die Eingabetaste.

Sie sollten dann Folgendes sehen:

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

Wenn Folgendes angezeigt wird:

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

müssen Sie also die Datei /setup/setenv.sh im Plattformprobenverteilung. Eine Anleitung finden Sie in der README-Datei oder in den Apigee Edge APIs.

Bei Erfolg komprimiert das Bereitstellungs-Tool die Dateien unter /apiproxy, Importen im ZIP-Format das Paket in Ihrer Organisation in Apigee Edge und stellt dann den API-Proxy im Test „Test“ bereit zu verbessern.

Ihr API-Proxy kann jetzt aufgerufen werden.