Bereitstellungsübersicht

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Hinweis: Zur Bereitstellung von API-Proxys in Umgebungen, die für Archivbereitstellungen aktiviert sind, lesen Sie die Informationen unter Archive in einer Apigee-Umgebung bereitstellen und verwalten.

Wenn Sie Änderungen an einem API-Proxy vornehmen, können Sie ihn als neue Überarbeitung speichern und in Ihrem Cluster bereitstellen.

Schnelleinstieg:

• API-Proxy bereitstellen
• Bereitstellung eines API-Proxys aufheben

Informationen zur Bereitstellung

Der Bereitstellungslebenszyklus einer API-Proxy-Überarbeitung für Apigee ist in der folgenden Abbildung dargestellt.

Hinweis: In Apigee agieren MPs unabhängig voneinander und beliebige MPS können einen anderen Status haben als die anderen MPs, beispielsweise aktiv oder deaktiviert. Dies wird als Eventual Consistency-Bereitstellungsmodell für API-Proxys bezeichnet.

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:

1. Überarbeitung 1 des API-Proxy-/hello wird bereitgestellt und verarbeitet.
2. Überarbeitung 2 von /hello wird bereitgestellt.
3. Überarbeitung 2 wird auf den Message Processor auf der Laufzeitebene bereitgestellt.
4. Die Bereitstellung von Überarbeitung 1 wird aufgehoben.

Die Bereitstellung der API-Proxy-Überarbeitung wurde ohne Ausfallzeiten abgeschlossen.

Hinweis: Wenn die Bereitstellung von Überarbeitung 2 aus irgendeinem Grund fehlschlägt, wird die Vorgängerversion 1 noch nicht bereitgestellt. In diesem Fall können Sie die vorherige Überarbeitung noch einmal bereitstellen, um sie wiederherzustellen. Anschließend können Sie die neue Überarbeitung korrigieren und bereitstellen.

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

Wählen Sie Entwickeln > API-Proxys aus. 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. gibt an, dass in der ausgewählten Umgebung keine Fehler oder Warnungen für diesen Proxy vorliegen. zeigt an, dass einige Routings aufgrund von Pfadkonflikten nicht aktualisiert wurden. gibt an, dass beim Bereitstellen des API-Proxys ein Fehler aufgetreten ist. 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.

Nutzung der Proxybereitstellung ansehen

Die Nutzung von API-Proxys in Ihrer Organisation unterliegt möglicherweise einem Bereitstellungskontingent, das beschränkt, wie viele Bereitstellungseinheiten Sie gleichzeitig verwenden können. Weitere Informationen finden Sie in den Berechtigungsinformationen (Pay-as-you-go oder Abo) Sie können die Nutzung der Proxybereitstellung Ihrer Organisation wie unten beschrieben an verschiedenen Stellen in der Apigee-UI in der Cloud Console aufrufen.

Deployment-Nutzung auf der Apigee-Übersichtsseite ansehen

So rufen Sie die Nutzung der API-Proxy-Bereitstellung auf der Apigee-Seite Übersicht auf:

1. Öffnen Sie die Seite Übersicht in der Apigee-UI in der Google Cloud Console.

   Zur Übersicht

2. Auf der Karte Proxynutzung werden die folgenden Informationen für Ihre Organisation angezeigt, um die Nutzung der Proxybereitstellung für Ihr Unternehmen auf einen Blick zu sehen:
   • Bereitgestellte Proxys: Die Gesamtzahl der in Ihrer Organisation bereitgestellten API-Proxy-Überarbeitungen.
   • Proxy-Bereitstellungseinheiten: Die Gesamtzahl der API-Proxy-Überarbeitungen, die in Ihrer Organisation bereitgestellt wurden. Jede Bereitstellung pro Umgebung und Instanz wird als eine Einheit gezählt.
   • Erweiterbare Bereitstellungseinheiten: Die Anzahl der erweiterbaren API-Proxy-Überarbeitungen, die in Ihrer Organisation bereitgestellt wurden. Jede Bereitstellung pro Umgebung und Instanz wird als eine Einheit gezählt.
   • Standardbereitstellungseinheiten: Die Anzahl der Standard-API-Proxy-Überarbeitungen, die in Ihrer Organisation bereitgestellt wurden. Jede Bereitstellung pro Umgebung und Instanz wird als eine Einheit gezählt.
3. Auf der Karte Umgebungen auf der Seite Übersicht können Sie auch das von Ihrer Organisation genutzte Kontingent aufrufen.

Deployment-Nutzung auf der Seite "API-Proxys" ansehen

So zeigen Sie die Nutzung des API-Proxys auf der Seite API-Proxys an:

1. Öffnen Sie die Seite API-Proxys in der Apigee-Benutzeroberfläche in der Google Cloud Console.

   Zu „API-Proxys“

2. Auf der Seite API-Proxys werden die folgenden Informationen angezeigt:
   • Gesamtzahl der Proxys: Die Gesamtzahl der API-Proxys, die in Ihrer Organisation entwickelt wurden.
   • Bereitgestellte Proxys: Die Gesamtzahl der API-Proxy-Überarbeitungen, die in allen Umgebungen Ihrer Organisation bereitgestellt wurden.
   • Gesamtzahl der Bereitstellungseinheiten: Die Gesamtzahl der API-Proxy-Überarbeitungen, die in allen Umgebungen Ihrer Organisation bereitgestellt wurden. Jede Bereitstellung pro Umgebung und Instanz wird als eine Einheit gezählt.
   • Bereitstellungseinheiten für erweiterbare Proxys: Die Anzahl der Überarbeitungen erweiterbarer API-Proxys, die in allen Umgebungen Ihrer Organisation bereitgestellt werden. Jede Bereitstellung pro Umgebung und Instanz wird als eine Einheit gezählt.
   • Standard-Proxy-Bereitstellungseinheiten: Die Anzahl der Standard-API-Proxy-Überarbeitungen, die in allen Umgebungen Ihrer Organisation bereitgestellt werden. Jede Bereitstellung pro Umgebung und Instanz wird als eine Einheit gezählt.

Deployment-Nutzung auf der Seite „Umgebungen“ ansehen

So zeigen Sie die Nutzung des API-Proxy-Deployments auf der Seite Umgebungen an:

1. Öffnen Sie die Seite Umgebungen in der Apigee-Benutzeroberfläche in der Google Cloud Console.

   Zur Seite Umgebungen“

2. Wählen Sie den Tab Umgebungen aus, um die folgenden Informationen für alle Umgebungen aufzurufen:
   • Gesamtzahl der Bereitstellungseinheiten: Die Gesamtzahl der API-Proxy-Überarbeitungen, die in allen Umgebungen Ihrer Organisation bereitgestellt wurden.
   • Bereitstellungseinheiten für erweiterbare Proxys: Die Anzahl der Überarbeitungen erweiterbarer API-Proxys, die in allen Umgebungen Ihrer Organisation bereitgestellt werden. Jede Bereitstellung pro Umgebung und Instanz wird als eine Einheit gezählt.
   • Standard-Proxy-Bereitstellungseinheiten: Die Anzahl der Standard-API-Proxy-Überarbeitungen, die in allen Umgebungen Ihrer Organisation bereitgestellt werden. Jede Bereitstellung pro Umgebung und Instanz wird als eine Einheit gezählt.
   • Bereitstellungseinheiten für freigegebene Abläufe: Die Gesamtzahl der Überarbeitungen freigegebener Abläufe, die in allen Umgebungen Ihrer Organisation bereitgestellt wurden. Jede Bereitstellung pro Umgebung und Instanz wird als eine Einheit gezählt.
   • Kontingent: Die Anzahl der Bereitstellungseinheiten, die Ihrer Organisation in allen Umgebungen Ihrer Organisation zur Verfügung stehen.
3. So rufen Sie die Proxybereitstellungsnutzung für eine einzelne Umgebung auf:
   1. Wählen Sie in der Liste Umgebungen einen Umgebungsnamen aus, um dessen Details aufzurufen.
   2. Wählen Sie den Tab Deployments aus, um die Nutzung von Bereitstellungseinheiten für die ausgewählte Umgebung aufzurufen.

Nächste Schritte

Bereitstellung: API-Proxy bereitstellen

So heben Sie die Bereitstellung auf: Bereitstellung eines API-Proxys aufheben