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: Stellt Informationen zu bereitgestellten Infrastrukturkomponenten bereit.
  • 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, die Terraform bei der Interaktion mit Google Cloud APIs und -Ressourcen unterstützen.

Weitere Informationen finden Sie unter Terraform inGoogle Cloud.

Wenn Sie keine eigenen Bereitstellungstools und ‑workflows haben, lesen Sie den Abschnitt Anwendung über dieGoogle Cloud Console bereitstellen.

Hinweise

Bitten Sie Ihren Administrator, Ihnen eine der folgenden Rollen für den app-fähigen Ordner oder das Verwaltungsprojekt zuzuweisen:

  • Anwendungsadministrator (roles/designcenter.applicationAdmin).
  • Application Editor (roles/designcenter.applicationEditor).

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 Seite Vorlagen auf.

    Vorlagen aufrufen

  2. Klicken Sie auf die Vorlagen-ID, 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, den 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. Sie können beispielsweise Daten exportieren, um Folgendes zu tun:

  • Verwenden Sie Ihre vorhandenen Workflows für die Versionsverwaltung.
  • Sie können Builds, Tests und Bereitstellungen über Ihre eigene CI/CD-Pipeline auslösen.

Verbindung zu Ihrem Repository herstellen

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

  1. Ändern Sie die Organisationsrichtlinie, um die folgenden Dienste auf die Zulassungsliste zu setzen:

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

    Eine Anleitung zum Ändern Ihrer Organisationsrichtlinie finden Sie unter Einschränkung „Nutzung von Dienstressourcen einschränken“ verwenden.

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

    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 die Gruppenbereichs-ID.

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

    Ersetzen Sie Folgendes:

    • PROJECT: Ihre Managementprojekt-ID.
    • LOCATION: Ihre Standort-ID.

  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:

    • SPACE: Ihre Bereichs-ID.
    • PROJECT: Ihre Managementprojekt-ID.
    • LOCATION: Ihre Standort-ID.

  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 Bereichs-ID.
    • PROJECT: Ihre Managementprojekt-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. Sehen Sie sich Ihr Repository an, um zu prüfen, ob die Vorlage erfolgreich exportiert wurde.

Anwendung

  1. Ermitteln Sie die Gruppenbereichs-ID.

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

    Ersetzen Sie Folgendes:

    • PROJECT: Ihre Managementprojekt-ID.
    • LOCATION: Ihre Standort-ID.

  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:

    • SPACE: Ihre Bereichs-ID.
    • PROJECT: Ihre Managementprojekt-ID.
    • LOCATION: Ihre Standort-ID.

  3. Terraform-Code für Ihre Anwendung generieren und nach GitHub exportieren

    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 Bereichs-ID.
    • PROJECT: Ihre Managementprojekt-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. Sehen Sie sich Ihr Repository an, um zu prüfen, ob die Anwendung erfolgreich exportiert wurde.

Nächste Schritte

Übersicht über Terraform in Google Cloud