Schritt 8: Archiv zur Produktion hochstufen

Diese Seite gilt für Apigee und Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

In diesem Schritt stufen Sie ein Archiv der API-Proxykonfiguration in einer Produktionsumgebung in Ihrer Apigee-Organisation hoch.

  1. Führen Sie die Schritte unter Umgebung erstellen aus, um Folgendes durchzuführen:
    1. Erstellen Sie eine neue prod-Umgebung in Ihrer Apigee-Organisation und aktivieren Sie Archiv als Bereitstellungstyp Verwenden Sie die UI oder die API

      Beispiel:

      Dialogfeld "Neue Umgebung" mit den Einstellungen für die Option "Archivtyp"

    2. Hängen Sie die Umgebung mithilfe der Instances Attachment API an die Laufzeitinstanz an.

      Dieser Befehl löst einen Vorgang mit langer Ausführungszeit aus. Prüfen Sie, bevor Sie fortfahren, ob die Umgebung an die Laufzeit angehängt wurde.

    3. Erstellen Sie mit der API Umgebungsgruppen erstellen eine Umgebungsgruppe, wenn Sie noch keine haben.

      Prüfen Sie, ob die Umgebungsgruppe erstellt wurde, bevor Sie fortfahren. Sie können dann den Status der neuen Gruppe mithilfe einer Anfrage wie der folgenden prüfen:

      curl -i -H "$AUTH" -H "Content-Type:application/json" \
        "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
    4. Hängen Sie die neue Umgebung mithilfe der Environment Group Attachment API an die Umgebungsgruppe an.

      Durch Anhängen einer Umgebung an die Gruppe sind die Proxys in dieser Umgebung nur über die Hostnamen in der Gruppe routingfähig. Dadurch wird ein lang andauernder Vorgang ausgelöst, der einige Minuten dauern kann. Wir empfehlen, ein bis zwei Minuten zu warten, bevor Sie mit dem nächsten Schritt fortfahren. In der Zwischenzeit können Sie den Status des Vorgangs wie zuvor prüfen.

  2. Erstellen Sie eine neue prod-Umgebung in Ihrer lokalen Entwicklungsumgebung:
    1. Bewegen Sie den Mauszeiger im Apigee-Bereich von VS Code auf den Ordner environments und klicken Sie auf Symbol "Erstellen".

      + wird angezeigt, wenn Sie den Mauszeiger über den Ordner "environments" halten.

      Der Assistent zum Erstellen einer Umgebung wird geöffnet.

    2. Geben Sie als Umgebungsnamen prod ein und drücken Sie die Eingabetaste.

      Die Umgebung wird erstellt.

    3. Maximieren Sie den Ordner prod im Apigee-Bereich, um dessen Inhalt anzuzeigen.
    4. Bewegen Sie den Mauszeiger über die Datei deployments.json im Apigee-Bereich und klicken Sie auf Symbol „Konfigurieren“.

      Der Assistent für Bereitstellungen wird geöffnet.

    5. Wählen Sie den API-Proxy helloworld aus, um ihn dem Deployment hinzuzufügen, und klicken Sie auf OK.

      Die Datei deployments.json wird im Dateieditor geöffnet. Die Datei wurde aktualisiert und enthält den helloworld-API-Proxy in das proxies-Bereitstellungsarray, wie unten gezeigt:

      {
        "proxies": [
           "helloworld"
        ],
        "sharedflows": []
      }
  3. Stellen Sie ein Archiv Ihrer API-Proxykonfiguration in der Umgebung prod Ihrer Apigee-Organisation bereit.
    1. Gehen Sie auf dem Tab Terminal in Apigee VS Code zum Verzeichnis myapigeeworkspace.
      cd myapigeeworkspace
    2. Führen Sie dazu diesen Befehl aus:
      gcloud beta apigee archives deploy --environment=prod --labels=release=052021.1

      Im Folgenden finden Sie ein Beispiel für die Antwort:

      Using Apigee organization dev
      Waiting for operation [$OPERATION_ID] to complete...⠹
    3. Führen Sie den folgenden Befehl aus, um den Status des Vorgangs zu prüfen. Ersetzen Sie dabei $OPERATION_ID durch die Vorgangs-ID, die im vorherigen Aufruf zurückgegeben wurde:
      gcloud beta apigee operations describe $OPERATION_ID

      Im Folgenden finden Sie ein Beispiel für die Antwort: state ist auf IN_PROGRESS eingestellt.

      Using Apigee organization 'prod'
      done: true
      metadata:
        '@type': type.googleapis.com/google.cloud.apigee.v1.OperationMetadata
        operationType: INSERT
        state: IN_PROGRESS
        targetResourceName: uri
      name: organizations/prod/operations/$OPERATION_ID
      organization: prod
      response:
        '@type': type.googleapis.com/google.cloud.apigee.v1.CanaryEvaluation
        control: 1-5-0-20210319-071117-ghq74
        endTime: '2021-03-20T06:15:44.329363950Z'
        metricLabels:
          env: test
          location: us-central1
        name: uri
        startTime: '2021-03-20T06:14:44.306534584Z'
        treatment: 1-5-0-20210319-190954-if0wk
        verdict: NONE
      uuid: $OPERATION_ID
    4. Wiederholen Sie den vorherigen Schritt, bis state auf FINISHED gesetzt ist. Damit wird angezeigt, dass die Archivierung abgeschlossen ist.
    5. Führen Sie den folgenden Befehl aus, um alle Archivbereitstellungen in der Umgebung prod aufzurufen:
      gcloud beta apigee archives list --environment=prod

      Im Folgenden finden Sie ein Beispiel für die Antwort:

      Using Apigee organization 'prod'
      ARCHIVE ID                        ENVIRONMENT   DEPLOYED AT           LABELS            OPERATION STATUS
      vrytwbhso558oil53m                prod          2021-04-20 21:20:53   release=052021.1  Deployed

Das wars! Sie haben Ihr API-Archiv erfolgreich in eine Apigee-Produktionsumgebung hochgestuft.