Diese Seite gilt für Apigee und Apigee Hybrid.
Apigee Edge-Dokumentation aufrufen
Wenn Sie Änderungen an einem API-Proxy vornehmen, können Sie ihn als neue Überarbeitung speichern und in Ihrem Cluster bereitstellen.
Informationen zur Bereitstellung
Der Bereitstellungslebenszyklus einer API-Proxy-Überarbeitung für Apigee ist in der folgenden Abbildung dargestellt.
Einschränkungen zu API-Proxy-Überarbeitungen
Die folgenden Einschränkungen gelten für API-Proxy-Überarbeitungen:
- Wenn Sie Änderungen an einem API-Proxy vornehmen, müssen Sie ihn als neue Überarbeitung bereitstellen.
- Nachdem Sie einen API-Proxy bereitgestellt haben, ist die Überarbeitung schreibgeschützt. Sie können keine API-Proxy-Revision ändern, etwa um inkrementelle Änderungen vorzunehmen; Die einzige Möglichkeit, eine Überarbeitung zu ändern, besteht darin, eine neue Überarbeitung zu erstellen und bereitzustellen.
- MPs können ein Proxy-Bundle nur in ihrer Gesamtheit bereitstellen. Wenn Sie Änderungen nur an einzelnen Fragmenten oder Richtlinien vornehmen, stellen die MPs trotzdem das gesamte Proxy-Bundle bereit.
- Wenn Ihre Apigee-Nutzung zwischen Standard- und erweiterbaren Proxys unterscheidet, wenn Sie eine Überarbeitung bereitstellen, die einen API-Proxy von einem Standard-Proxy in einen erweiterbaren Proxy ändert, gilt Folgendes:
- Es können Kosten anfallen. Wenn Sie ein „Pay as you go“-Kunde sind, finden Sie weitere Informationen unter „Pay as you go“-Berechtigungen. Wenn Sie ein Abo-Kunde sind, sehen Sie sich die Details Ihres Abos an.
- Die Bereitstellung erfordert zusätzliche Zeit. Während des Bereitstellungszeitraums wird der API-Aufrufablauf nicht unterbrochen. Sie können den Proxy aber weder bereitstellen, noch seine Bereitstellung aufheben oder löschen. Außerdem können aktuelle oder neue Überarbeitungen während des Bereitstellungszeitraums nicht gelöscht werden. Änderungen am API-Proxy und neue Überarbeitungen sind zulässig.
Bereitstellung ohne Ausfallzeiten
Alle erfolgreichen API-Proxy-Deployments in Apigee sind Deployment-Ausfälle mit Ausfallzeiten. API-Proxy-Bereitstellungen erfolgen in folgender Reihenfolge:
- Überarbeitung 1 des API-Proxy-
/hello
wird bereitgestellt und verarbeitet. - Überarbeitung 2 von
/hello
wird bereitgestellt. - Überarbeitung 2 wird auf den Message Processor auf der Laufzeitebene bereitgestellt.
- Die Bereitstellung von Überarbeitung 1 wird aufgehoben.
Die Bereitstellung der API-Proxy-Überarbeitung wurde ohne Ausfallzeiten abgeschlossen.
Bereitstellungsstatus aufrufen
Die Bereitstellung eines API-Proxys auf Apigee stellt sie nicht sofort zur Verfügung. Es dauert eine Weile, bis der API-Proxy auf allen MPs auf der Laufzeitebene synchronisiert ist. Apigee stellt jedoch Tools zur Verfügung, mit denen Sie Informationen über den Status Ihrer API-Proxy-Revisionen erhalten können.
Apigee-Benutzeroberfläche
In der Apigee-Benutzeroberfläche gibt es mehrere Ansichten, in denen der Bereitstellungsstatus Ihrer API-Proxys zu sehen ist.
Apigee-Benutzeroberfläche anzeigen | Schritte und Beschreibung |
---|---|
Proxys |
Die Apigee-Benutzeroberfläche verwendet die folgenden Symbole, um für jeden API-Proxy den Status in Kurzform anzugeben: gibt an, dass der API-Proxy nicht in der ausgewählten Umgebung bereitgestellt wurde. Klicken Sie zum Anzeigen des Statussymbols auf den Tab Entwickeln. Alternativ können Sie Entwickeln > API-Proxys auswählen und auf einen API-Proxy klicken. |
Apigee API
Verwenden Sie den folgenden API-Aufruf, um den Bereitstellungsstatus Ihrer API-Proxy-Revision in einer Umgebung anzuzeigen:
curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \ -X GET \ -H "Authorization: Bearer $TOKEN"
Dabei ist $TOKEN
auf Ihr OAuth 2.0-Zugriffstoken festgelegt. Weitere Informationen hierzu finden Sie unter OAuth 2.0-Zugriffstoken abrufen. Informationen zu den in diesem Beispiel verwendeten curl
-Optionen finden Sie unter curl verwenden. Eine Beschreibung der verwendeten Umgebungsvariablen findet sich unter Umgebungsvariablen für Apigee API-Anfragen festlegen.
Im Folgenden finden Sie ein Beispiel für die Antwort: Dieses Beispiel zeigt den Bereitstellungsstatus für die Überarbeitung 1
des API-Proxys helloworld
, der in der Umgebung test
bereitgestellt wird:
{ "environment": "test", "apiProxy": "helloworld", "revision": "1", "deployStartTime": "1559149080457", "pods": [ { "podName": "apigee-runtime-myorg-test-f8bdf9d-2s72w", "deploymentStatus": "deployed", "statusCodeDetails": "Deployment Success", "podStatus": "active", "podStatusTime": "1595357668001" } ], "state": "READY" }
Weitere Informationen finden Sie unter API Proxy Revision Environment Deployments API.
gcloud
Verwenden Sie den folgenden gcloud-Befehl, um den Bereitstellungsstatus Ihrer API-Proxy-Revision in einer Umgebung anzuzeigen:
gcloud alpha apigee deployments describe --api=$API --environment=$ENV
Weitere Informationen und Details zu den in den Beispielen verwendeten Umgebungsvariablen finden Sie unter Erste Schritte mit gcloud mit Apigee.
Im Folgenden finden Sie ein Beispiel für die Antwort: Dieses Beispiel zeigt den Bereitstellungsstatus für die Überarbeitung 1
des API-Proxys helloworld
, der in der Umgebung test
bereitgestellt wird:
Using Apigee organization `my-org` Using deployed revision `1` apiProxy: helloworld deployStartTime: '1598032332802' environment: test pods: - deploymentStatus: deployed podName: apigee-runtime-myorg-test-f8bdf9d-2s72w podStatus: active podStatusTime: '1598302128087' statusCodeDetails: Deployment Success revision: '1' state: READY
Weitere Informationen finden Sie unter Befehlszeilen-Deployments beschreiben.
Nächste Schritte
Bereitstellung:
|
So heben Sie die Bereitstellung auf: Bereitstellung eines API-Proxys aufheben
|