VPC mit Terraform bereitstellen

Sie können ein VPC-Netzwerk (Virtual Private Cloud) mit Infrastructure Manager und derGoogle Cloud Console bereitstellen. Diese Kurzanleitung richtet sich an Cloud-Administratoren, Plattform-Engineers und Entwickler, die die Infrastruktur von Google Cloud als Code verwalten möchten. Ein VPC-Netzwerk bietet isolierte Netzwerke für Ressourcen wie VM-Instanzen, Datenbanken und Anwendungen.

Mit Infra Manager definieren Sie das Netzwerk in einer Terraform-Konfiguration, anstatt es manuell zu erstellen. Infra Manager führt Terraform für Sie aus und speichert den Terraform-Zustand. So können Sie Ihre Infrastruktur konsistent reproduzieren, aktualisieren und löschen. Weitere Informationen finden Sie unter Übersicht über Terraform in Google Cloud.

In dieser Kurzanleitung erstellen Sie eine Vorabversion und ein Deployment aus einer Terraform-Konfiguration in einem öffentlichen GitHub-Repository.

Hinweis

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Infrastructure Manager and Compute Engine APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen der Kurzanleitung benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Vorschau eines Deployments ansehen und Deployment erstellen

Wenn Sie ein Deployment erstellen, stellt Infra Manager die in der Terraform-Konfiguration definierten Ressourcen bereit. Bevor Sie das Deployment erstellen, erstellen Sie eine Vorschau, um zu prüfen, welche Ressourcen Infra Manager bereitstellen wird.

So rufen Sie eine Vorschau auf und erstellen ein Deployment, das ein VPC-Netzwerk bereitstellt:

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

    Zu Infrastructure Manager

  2. Klicken Sie auf Neues Deployment erstellen.

  3. Geben Sie auf der Seite Neue Terraform-Bereitstellung erstellen im Abschnitt Bereitstellungsdetails die folgenden Werte ein:

    • Bereitstellungs-ID: quickstart-preview
    • Region: us-central1
    • Terraform-Version: 1.5.7
    • Dienstkonto: Erstellen Sie ein neues Dienstkonto mit dem Namen im-quickstart-sa. So erstellen Sie das Dienstkonto und weisen ihm die erforderlichen Rollen zu:

      1. Klicken Sie in der Liste Dienstkonto auf Neues Dienstkonto. Die Seite Dienstkonto erstellen wird in einem neuen Tab geöffnet.
      2. Geben Sie im Feld Name des Dienstkontos im-quickstart-sa ein und klicken Sie dann auf Erstellen und fortfahren.
      3. Verwenden Sie im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt erteilen die Liste Rolle auswählen, um die folgenden Rollen zuzuweisen. Klicken Sie auf Weitere Rolle hinzufügen, um die zweite Rolle hinzuzufügen.

        • Cloud Infrastructure Manager Agent (roles/config.agent): Ermöglicht Infra Manager, Terraform auszuführen und den Status und die Logs des Deployments zu speichern.
        • Compute-Netzwerkadministrator (roles/compute.networkAdmin): Ermöglicht Infra Manager, das VPC-Netzwerk zu erstellen und zu verwalten.

        Weitere Informationen zu Infra Manager-Rollen finden Sie unter Zugriffssteuerung mit IAM.

      4. Klicken Sie auf Weiter und dann auf Fertig.

      5. Schließen Sie den Tab und kehren Sie zur Seite Neue Terraform-Bereitstellung erstellen zurück.

      6. Klicken Sie in der Liste Dienstkonto auf Liste aktualisieren und wählen Sie dann im-quickstart-sa aus.

    • Quelle der Terraform-Konfiguration: Git

    • Git-Repository: https://github.com/terraform-google-modules/terraform-google-network

    • Git-Verzeichnis: modules/vpc

  4. Klicken Sie auf Weiter.

  5. Geben Sie im Abschnitt Terraform-Details unter Eingabewerte die folgenden Werte für die vorab ausgefüllten Modulvariablen ein:

    • Geben Sie in der Zeile für den Schlüssel project_id im Feld Wert den Wert <var>PROJECT_ID</var> ein. Verwenden Sie keine Anführungszeichen.
    • Geben Sie in der Zeile für den Schlüssel network_name im Feld Wert den Wert quickstart-vpc ein. Verwenden Sie keine Anführungszeichen.

    Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .

  6. Klicken Sie auf Vorschau erstellen.

  7. Prüfen Sie auf der Detailseite für die Vorabversion quickstart-preview-<var>UUID</var>, ob der Wert in der Zeile Status Erfolgreich ist.

  8. Klicken Sie auf Deployment erstellen, um ein Deployment mit den Werten aus der Vorschau zu erstellen.

  9. Geben Sie im Feld Bereitstellungs-ID den Wert quickstart-deployment ein.

  10. Klicken Sie auf Deployment erstellen.

    Infra Manager stellt das VPC-Netzwerk bereit. Wenn die Bereitstellung abgeschlossen ist, erhalten Sie eine Benachrichtigung in der Google Cloud Console.

Sie haben ein Deployment mit Infra Manager erstellt. In den folgenden Abschnitten überprüfen Sie die Bereitstellung, rufen das bereitgestellte Netzwerk auf und prüfen den Cloud Build-Job, der Terraform ausgeführt hat.

Status der Bereitstellung ansehen

Nachdem Infra Manager das Deployment erstellt hat, können Sie sich Details dazu ansehen, z. B. den Status, die neueste Überarbeitung und die Quelle der Terraform-Konfiguration.

So rufen Sie die Details der Bereitstellung auf:

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

    Zu Infrastructure Manager

  2. Klicken Sie in der Spalte ID auf quickstart-deployment.

  3. Prüfen Sie auf der Detailseite der Bereitstellung, ob der Wert in der Zeile Status Aktiv ist.

Bereitgestelltes VPC-Netzwerk ansehen

Prüfen Sie in der Google Cloud Konsole, ob Infra Manager das in der Terraform-Konfiguration definierte Netzwerk bereitgestellt hat:

  1. Rufen Sie in der Google Cloud Console die Seite VPC-Netzwerke auf.

    Zur Seite VPC-Netzwerke

    Die Liste der Netzwerke enthält quickstart-vpc, das von Infra Manager bereitgestellte Netzwerk. Die Liste enthält Details zum Netzwerk, z. B. den Modus für die Subnetzerstellung, die maximale Übertragungseinheit (MTU) und den dynamischen Routingmodus.

  2. Klicken Sie auf quickstart-vpc, um weitere Details zum Netzwerk aufzurufen, z. B. zu den Subnetzen, Firewallregeln und Routen.

Build-Ergebnisse in Cloud Build ansehen

Infra Manager verwendet Cloud Build, um Terraform für jede Bereitstellungsversion auszuführen. Wenn Sie die Terraform-Befehle prüfen möchten, mit denen Ihre Bereitstellung erstellt wurde, oder wenn Sie Fehler in einer fehlgeschlagenen Bereitstellung beheben möchten, rufen Sie die Cloud Build-Build-Logs auf:

  1. Rufen Sie in der Google Cloud Console die Seite Build-Verlauf auf.

    Build-Verlauf aufrufen

  2. Suchen Sie in der Build-Tabelle nach dem neuesten Build mit der Region us-central1. In dieser Liste werden Builds sowohl für die quickstart-preview-<var>UUID</var>-Vorschau als auch für das quickstart-deployment-Deployment angezeigt.

  3. Klicken Sie auf die Build-ID, um die Seite Build-Details zu öffnen.

    Auf der Seite Build-Details werden der Status der einzelnen Build-Schritte und das Build-Log mit der Ausgabe der Terraform-Befehle angezeigt. Wenn eine Bereitstellung fehlschlägt, können Sie die Ursache anhand des Build-Logs ermitteln. Weitere Informationen finden Sie unter Bereitstellungsfehler beheben.

Sie können den Build für ein Deployment auch auf der Detailseite des Deployments in Infra Manager öffnen, indem Sie auf den Link Cloud Build-Logs klicken.

Bereinigen

Damit Ihrem Google Cloud -Konto die in dieser Kurzanleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie die Bereitstellung, wenn Sie sie nicht mehr benötigen. Für Bereitstellungsvorschauen fallen keine Gebühren für Ihr Google Cloud -Konto an. Wenn Sie die Vorschau löschen möchten, lesen Sie den Abschnitt Vorschauen löschen.

Bereitstellung löschen

Löschen Sie das Deployment und das bereitgestellte VPC-Netzwerk:

So löschen Sie die Bereitstellung:

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

    Zu Infrastructure Manager

  2. Klicken Sie in der Spalte ID auf quickstart-deployment.

  3. Klicken Sie auf der Detailseite der Bereitstellung auf Löschen.

  4. Geben Sie im Bestätigungsdialogfeld quickstart-deployment ein und klicken Sie dann auf Bestätigen.

Dienstkonto löschen

Nachdem Infra Manager die Bereitstellung gelöscht hat, löschen Sie das Dienstkonto im-quickstart-sa, damit es seine Rollen in Ihrem Projekt nicht behält:

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

    Zur Seite „Dienstkonten“

  2. Klicken Sie auf das Kästchen für im-quickstart-sa und dann auf Löschen.

  3. Klicken Sie im Dialogfeld auf Löschen.

Optional: Projekt löschen

Wenn Sie die Bereitstellung in einem neuen Google Cloud -Projekt erstellt haben und das Projekt nicht mehr benötigen, löschen Sie es.

  1. Wechseln Sie in der Google Cloud -Console zur Seite Ressourcen verwalten.

    Zur Seite „Ressourcen verwalten“

  2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.

  3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Beenden.

Nächste Schritte