Terraform herunterladen und bereitstellen

Wenn Sie eigene Bereitstellungstools und ‑workflows haben, können Sie Vorlagen oder Anwendungen als Terraform-Dateien herunterladen.

Das System generiert die folgenden Terraform-Dateien:

  • main.tf: Infrastrukturcode, der ein Modul für jede Komponente in der Vorlage enthält.
  • outputs.tf: Macht Informationen zu Infrastrukturkomponenten verfügbar, die bereitgestellt werden.
  • variables.tf: Deklariert Name, Typ und Beschreibung für Variablen, die in der Datei main.tf verwendet werden.
  • input.tfvars: Definiert Werte für Variablen, die in der Datei main.tf verwendet werden.
  • providers.tf: Definiert Labels, mit denen Terraform mit Google Cloud APIs und Ressourcen interagieren kann.

Hintergrundinformationen finden Sie unter Übersicht über Terraform in Google Cloud.

Wenn Sie keine eigenen Bereitstellungstools und ‑workflows haben, lesen Sie Anwendung über die Console Google Cloud bereitstellen.

Hinweis

Bitten Sie Ihren Administrator, Ihnen die erforderlichen Rollen für den Ordner mit aktivierter App oder das Verwaltungsprojekt zuzuweisen, um die Aufgaben in diesem Dokument auszuführen. Die erforderlichen Rollen sind in der folgenden Tabelle aufgeführt:

Aufgabe Erforderliche Rollen
Generierten Terraform-Code lokal oder in ein Quellcodeverwaltungs-Repository exportieren Anwendungsadministrator (roles/designcenter.applicationAdmin) oder
Anwendungseditor (roles/designcenter.applicationEditor)

Weitere Informationen zu Rollen finden Sie unter Zugriffssteuerung mit IAM.

Terraform-Code exportieren

Wenn Sie Ihre Vorlagen und Anwendungen außerhalb von Google Cloudverwalten möchten, können Sie Terraform-Code generieren und auf Ihren lokalen Computer oder in Ihr Code Repository exportieren.

Lokal exportieren

Sie können Terraform-Code exportieren, der aus einer Vorlage oder einer Anwendung generiert wurde.

Vorlage

  1. Rufen Sie in der Google Cloud Console die Vorlagen Seite auf.

    Vorlagen aufrufen

  2. Klicken Sie auf die Vorlagen-ID der Vorlage, die Sie exportieren möchten.

  3. Klicken Sie auf Code abrufen.

    Das System lädt eine ZIP-Datei auf Ihren lokalen Computer herunter. Sie können die Anwendung mit Ihren eigenen Bereitstellungstools und ‑workflows bereitstellen.

Anwendung

  1. Rufen Sie in der Google Cloud Console die Seite Anwendungen auf.

    Wechseln Sie zu „Anwendungen“

  2. Klicken Sie auf den Anwendungsnamen der Anwendung, die Sie exportieren möchten.

  3. Klicken Sie auf Code abrufen.

    Das System lädt eine ZIP-Datei auf Ihren lokalen Computer herunter. Sie können die Anwendung mit Ihren eigenen Bereitstellungstools und ‑workflows bereitstellen.

In Ihr Repository exportieren

Wenn Sie Ihre Vorlagen über Ihr Quellcodeverwaltungs-Repository verwalten möchten, können Sie Vorlagen und Anwendungen nach GitHub exportieren. Anschließend können Sie Ihre vorhandenen Workflows zur Versionsverwaltung verwenden und Builds, Tests und Bereitstellungen mit Ihrer eigenen CI/CD-Pipeline auslösen.

Mit Ihrem Repository verbinden

So erstellen Sie eine Developer Connect-Verbindung zwischen Ihrem GitHub-Repository und Ihrem Verwaltungsprojekt:

  1. Ändern Sie Ihre Organisationsrichtlinie, um die folgenden Dienste Ihrer Zulassungsliste hinzuzufügen:

    1. developerconnect.googleapis.com.
    2. secretmanager.googleapis.com.

    Eine Anleitung zum Ändern Ihrer Organisationsrichtlinie finden Sie unter Einschränkung zur Nutzung von Ressourcendiensten einschränken verwenden.

  2. Erstellen Sie eine Developer Connect-Verbindung zu Ihrem GitHub-Repository, einschließlich der folgenden Schritte:

    1. Wählen Sie Datenstandort aktivieren aus.
    2. Verknüpfen Sie das Repository, in das Sie Ihre Anwendung exportieren möchten.

    Eine Anleitung zum Erstellen einer Verbindung und zum Verknüpfen eines Repositorys finden Sie unter GitHub verbinden.

  3. So kopieren Sie die Repository-URI:

    1. Öffnen Sie die Seite Developer Connect-Git-Repositories.
    2. Klicken Sie in der Tabelle Repositories auf Weitere Optionen und wählen Sie Ressourcenpfad kopieren aus.

Generieren und exportieren

So generieren Sie Terraform-Code und exportieren ihn in Ihr GitHub-Repository:

Vorlage

  1. Ermitteln Sie Ihre Space-ID.

    gcloud design-center spaces list \
    --project=PROJECT \
    --location=LOCATION

    Ersetzen Sie Folgendes:

  2. Ermitteln Sie die Vorlagen-ID der Vorlage, die Sie exportieren möchten.

    gcloud design-center spaces application-templates list \
    --space=SPACE \
    --project=PROJECT \
    --location=LOCATION

    Ersetzen Sie Folgendes:

  3. Generieren Sie den Terraform-Code Ihrer Vorlage und exportieren Sie ihn nach GitHub.

    gcloud design-center spaces application-templates generate APPLICATION_TEMPLATE \
    --space=SPACE \
    --project=PROJECT \
    --location=LOCATION \
    --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI \
    --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR \
    --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH

    Ersetzen Sie Folgendes:

    • APPLICATION_TEMPLATE: Die Vorlagen-ID der Vorlage, die Sie exportieren möchten.
    • SPACE: Ihre Space-ID.
    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Ihre Standort-ID.
    • DEVELOPER_CONNECT_EXPORT_CONFIG_DIR: Das Verzeichnis relativ zu Ihrem GitHub-Repository.
    • DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH: Der Branch in Ihrem GitHub-Repository.

    Weitere Informationen finden Sie unter gcloud design-center spaces application-templates generate.

  4. Prüfen Sie in Ihrem Repository, ob die Vorlage erfolgreich exportiert wurde.

Anwendung

  1. Ermitteln Sie Ihre Space-ID.

    gcloud design-center spaces list \
    --project=PROJECT \
    --location=LOCATION

    Ersetzen Sie Folgendes:

  2. Ermitteln Sie die Anwendungs-ID der Anwendung, die Sie exportieren möchten.

    gcloud design-center spaces applications list \
    --space=SPACE \
    --project=PROJECT \
    --location=LOCATION

    Ersetzen Sie Folgendes:

  3. Generieren Sie den Terraform-Code Ihrer Anwendung und exportieren Sie ihn nach GitHub.

    gcloud design-center spaces applications generate APPLICATION \
    --space=SPACE \
    --project=PROJECT \
    --location=LOCATION \
    --developer-connect-export-config-repo-uri=DEVELOPER_CONNECT_EXPORT_CONFIG_REPO_URI \
    --developer-connect-export-config-dir=DEVELOPER_CONNECT_EXPORT_CONFIG_DIR \
    --developer-connect-export-config-branch=DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH

    Ersetzen Sie Folgendes:

    • APPLICATION: Die Anwendungs-ID der Anwendung, die Sie exportieren möchten.
    • SPACE: Ihre Space-ID.
    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Ihre Standort-ID.
    • DEVELOPER_CONNECT_EXPORT_CONFIG_DIR: Das Verzeichnis relativ zu Ihrem GitHub-Repository.
    • DEVELOPER_CONNECT_EXPORT_CONFIG_BRANCH: Der Branch in Ihrem GitHub-Repository.

    Weitere Informationen finden Sie unter gcloud design-center spaces applications generate.

  4. Prüfen Sie in Ihrem Repository, ob die Anwendung erfolgreich exportiert wurde.

Nächste Schritte