Terraform mit Apigee verwenden

HashiCorp Terraform ist ein IaC-Tool (Infrastructure as Code), mit dem Sie Apigee mithilfe von Code bereitstellen und konfigurieren können.

Wenn Sie Terraform mit Apigee verwenden, erstellen Sie Terraform-Dateien, die Ihre gewünschte Konfiguration für die Bereitstellung oder eine Funktion beschreiben. Wenn Sie die Konfiguration anwenden, erstellt Terraform einen Ausführungsplan und führt die Vorgänge aus, die zum Konfigurieren von Apigee erforderlich sind.

Auf dieser Seite wird die für Apigee verfügbare Terraform-Funktionalität zusammengefasst. Allgemeine Informationen zur Verwendung von Terraform mit Google Cloudfinden Sie in der Dokumentation zu Terraform für Google Cloud .

Hinweis

So richten Sie Terraform für Ihr Apigee-Projekt ein:

  1. Bereiten Sie Ihre Entwicklungsumgebung vor, entweder Cloud Shell oder eine lokale Shell:

    Cloud Shell

    Wenn Sie ein Onlineterminal mit bereits eingerichteter gcloud CLI und Terraform verwenden möchten, aktivieren Sie Cloud Shell.

    Unten auf dieser Seite wird eine Cloud Shell-Sitzung gestartet und eine Eingabeaufforderung angezeigt. Das Initialisieren der Sitzung kann einige Sekunden dauern.

    Hinweis: Cloud Shell ist in Terraform bereits integriert.

    Lokale Shell

    So verwenden Sie eine lokale Entwicklungsumgebung:

    1. Installieren Sie die Google Cloud CLI.

    2. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    3. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

      gcloud init
    4. Installieren Sie Terraform.

  2. Prüfen Sie, ob für Ihr Google Cloud Projekt die Abrechnung aktiviert ist.

  3. Aktivieren Sie die Cloud Resource Manager API und die Identity and Access Management (IAM) API:

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin), die die Berechtigung serviceusage.services.enable enthält. Weitere Informationen zum Zuweisen von Rollen 

    gcloud services enable cloudresourcemanager.googleapis.com  iam.googleapis.com
  4. Achten Sie darauf, dass Ihrem Google Cloud-Projekt die Google Cloud Platform - Resource Location Restriction-Einschränkung für Organisationsrichtlinien nicht hinzugefügt wurde.

Terraform-Ressourcen für Apigee

In der folgenden Tabelle sind die Features und Funktionen zusammengefasst, die Sie mit Terraform-Ressourcen für Apigee verwalten können. Diese Liste ist möglicherweise nicht vollständig. Alle Terraform-Ressourcen für Apigee finden Sie im GitHub-Repository für die Google Cloud Platform Cloud Foundation Fabric und in der HashiCorp Google Provider-Dokumentation für Apigee. Sehen Sie immer in diesen Ressourcen nach, um die neuesten Funktionen zu nutzen.

Apigee-Funktion Zusammenfassung der Terraform-Unterstützung Weitere Informationen
Apigee bereitstellen Apigee-Instanzen mit Terraform bereitstellen Bereitstellungsoptionen
Apigee API-Hub bereitstellen API-Hub mit Terraform konfigurieren und verwalten API-Hub mit Terraform bereitstellen
Erweiterte API-Sicherheit konfigurieren Sicherheitsprofile für die Risikobewertung und Überwachungsbedingungen konfigurieren (Version 2)

Ausschlusslisten für die Missbrauchserkennung konfigurieren
Sicherheitsmaßnahmen konfigurieren		 Erweiterte API-Sicherheit mit Terraform konfigurieren