Umgebungen löschen

In diesem Thema wird erläutert, wie Umgebungen in Apigee Hybrid gelöscht werden. Weitere Informationen finden Sie unter Umgebungen und Umgebungsgruppen.

Informationen zum Löschen von Umgebungen

Das Löschen einer Umgebung ist das Gegenteil der Umgebungserstellung und umfasst die folgenden Aufgaben:

  • Entfernen Sie die Laufzeitkomponenten der Umgebung aus dem Cluster und die Umgebung aus der Überschreibungsdatei.
  • Löschen Sie die Umgebung aus der Verwaltungsebene. Verwenden Sie dazu entweder die Apigee-Benutzeroberfläche oder die Delete Environments API.

So löschen Sie eine Umgebung

Angenommen, Sie haben zwei Umgebungen test und prod. Die Definitionen in der overrides-Datei könnten in etwa so aussehen:

...
envs:
  - name: test
    serviceAccountPaths:
      synchronizer: "your_keypath/PROJECT_ID-apigee-synchronizer.json"
      runtime: "your_keypath/PROJECT_ID-apigee-runtime.json"
  - name: prod
    serviceAccountPaths:
      synchronizer: "your_keypath/PROJECT_ID-apigee-synchronizer.json"
      runtime: "your_keypath/PROJECT_ID-apigee-runtime.json"
...

So löschen Sie die prod-Umgebung:

  1. Rufen Sie Ihre gcloud-Authentifizierungsdaten ab: 
    TOKEN=$(gcloud auth print-access-token)
  2. Trennen Sie die Umgebung vorsichtshalber von allen Umgebungsgruppen, an die sie angehängt ist. Dadurch wird verhindert, dass Traffic an die Umgebung weitergeleitet wird, bevor Sie die Laufzeitkomponenten entfernen.
    1. Listen Sie die Anhänge der Umgebungsgruppe auf und notieren Sie sich die name (Anhang-ID) des Anhangs, dessen environment prod ist:

      Kein Datenstandort

      curl -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups/ENV_GROUP/attachments"

      Datenstandort

      curl -H "Authorization: Bearer $TOKEN" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups/ENV_GROUP/attachments"

      Die Ausgabe sieht etwa so aus:

      {
  "environmentGroupAttachments": [
    {
      "name": "f6f2958f-a0a1-4260-b9e9-80eead82ff1d",
      "environment": "prod",
      "createdAt": "1789700385118",
      "environmentGroupId": "ENV_GROUP"
    }
  ]
}
    2. Löschen Sie den Anhang:

      Kein Datenstandort

      curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups/ENV_GROUP/attachments/ATTACHMENT_ID"

      Datenstandort

      curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups/ENV_GROUP/attachments/ATTACHMENT_ID"

    Wobei:

    • ORG_NAME ist der Name Ihrer Apigee-Organisation.
    • ENV_GROUP ist der Name der Umgebungsgruppe.
    • ATTACHMENT_ID ist der im vorherigen Schritt zurückgegebene Anhang name. Dies ist eine generierte ID, nicht der Name der Umgebung.
    • CONTROL_PLANE_LOCATION ist der Standort der Steuerungsebene Ihrer Organisation, wenn Sie den Datenstandort verwenden.

    Wiederholen Sie diese Schritte für jede Umgebungsgruppe, an die die Umgebung angehängt ist.

  3. Durch einen Probelauf können Sie die Entfernung der Laufzeitkomponenten testen: 
    helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE --dry-run
    • ENV_RELEASE_NAME ist der Name, mit dem Sie zuvor das Diagramm apigee-env für diese Umgebung installiert haben. Dies ist oft mit dem Umgebungsnamen identisch. Führen Sie helm list -n APIGEE_NAMESPACE aus, um die Releasenamen in Ihrem Namespace aufzulisten.
    • APIGEE_NAMESPACE ist der Namespace, in dem Sie Apigee Hybrid installiert haben, standardmäßig apigee.

    Mit der Option --dry-run wird die Deinstallation simuliert, ohne dass etwas entfernt wird. Die Ausgabe ist dieselbe wie bei der tatsächlichen Deinstallation. Im Gegensatz zu helm upgrade akzeptiert helm delete keinen Wert für --dry-run, z. B. --dry-run=server. Beispiel:

    helm delete prod -n apigee --dry-run
release "prod" uninstalled
  4. Wenn der Probelauf fehlerfrei ist, entfernen Sie die Laufzeitkomponenten: 
    helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE
  5. Öffnen Sie die Überschreibungsdatei und entfernen Sie die prod-Umgebungsdefinition aus envs. Behalten Sie nur die test-Definition bei. Beispiel: 
    ...
envs:
  - name: test
    serviceAccountPaths:
      synchronizer: "your_keypath/PROJECT_ID-apigee-synchronizer.json"
      runtime: "your_keypath/PROJECT_ID-apigee-runtime.json"
...
  6. Speichern Sie die Datei.
  7. Löschen Sie die Umgebung von der Verwaltungsebene. Sie können entweder die Apigee-Benutzeroberfläche oder die Delete Environments API verwenden.

    Apigee-Benutzeroberfläche

    1. Rufen Sie in der Google Cloud Console die Seite Apigee > Verwaltung > Umgebungen auf.

      Zur Seite „Umgebungen“

    2. Wählen Sie das Projekt Ihrer Apigee-Organisation aus.
    3. Klicken Sie in der Zeile der Umgebung prod auf Aktionen > Löschen.

    API

    Kein Datenstandort:

    curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://apigee.googleapis.com/v1/organizations/ORG_NAME/environments/prod"

    Datenstandort:

    curl -X DELETE -H "Authorization: Bearer $TOKEN" \
  "https://CONTROL_PLANE_LOCATION-apigee.googleapis.com/v1/organizations/ORG_NAME/environments/prod"

    Der Aufruf gibt einen Vorgang mit langer Ausführungszeit zurück. Das Löschen kann einige Minuten dauern.