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, mit denen Terraform mit Google Cloud APIs und Ressourcen interagieren kann.

Hintergrundinformationen finden Sie unter Übersicht: Terraform in Google Cloud.

Wenn Sie keine eigenen Bereitstellungstools und ‑workflows haben, finden Sie weitere Informationen unter Anwendung über die Console Google Cloud bereitstellen.

Hinweis

Bitten Sie Ihren Administrator, Ihnen eine der folgenden Rollen für den Ordner oder das Verwaltungsprojekt zuzuweisen, in dem die App aktiviert ist:

  • Anwendungsadministrator (roles/designcenter.applicationAdmin)
  • Anwendungsbearbeiter (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 Vorlagen Seite 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. 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 der Zulassungsliste hinzuzufügen:

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

    Eine Anleitung zum Ändern Ihrer Organisationsrichtlinie finden Sie unter Einschränkung zur Beschränkung der Ressourcendienstnutzung verwenden.

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

    1. Wählen Sie Datenresidenz 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 den 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:

    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Ihre Standort-ID.

  2. Ermitteln Sie die Vorlagen-ID für die Vorlage, die Sie exportieren möchten.

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

    Ersetzen Sie Folgendes:

    • SPACE: Ihre Space-ID.
    • PROJECT: Ihre Verwaltungs-Projekt-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 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:

    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Ihre Standort-ID.

  2. Ermitteln Sie die Anwendungs-ID für die Anwendung, die Sie exportieren möchten.

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

    Ersetzen Sie Folgendes:

    • SPACE: Ihre Space-ID.
    • PROJECT: Ihre Verwaltungs-Projekt-ID.
    • LOCATION: Ihre Standort-ID.

  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

Übersicht: Terraform in Google Cloud