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
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
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.
-
Verify that billing is enabled for your Google Cloud project.
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.enablepermission. 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.
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:
- Cloud Infrastructure Manager-Administrator (
roles/config.admin) - Dienstkontoadministrator (
roles/iam.serviceAccountAdmin) - Service Account User (
roles/iam.serviceAccountUser) - Projekt-IAM-Administrator (
roles/resourcemanager.projectIamAdmin) - Compute-Netzwerkbetrachter (
roles/compute.networkViewer) - Cloud Build-Betrachter (
roles/cloudbuild.builds.viewer) - Storage-Objekt-Betrachter (
roles/storage.objectViewer)
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:
Rufen Sie in der Google Cloud Console die Seite Infrastructure Manager auf.
Klicken Sie auf Neues Deployment erstellen.
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:- Klicken Sie in der Liste Dienstkonto auf Neues Dienstkonto. Die Seite Dienstkonto erstellen wird in einem neuen Tab geöffnet.
- Geben Sie im Feld Name des Dienstkontos
im-quickstart-saein und klicken Sie dann auf Erstellen und fortfahren. 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.
- Cloud Infrastructure Manager Agent (
Klicken Sie auf Weiter und dann auf Fertig.
Schließen Sie den Tab und kehren Sie zur Seite Neue Terraform-Bereitstellung erstellen zurück.
Klicken Sie in der Liste Dienstkonto auf Liste aktualisieren und wählen Sie dann
im-quickstart-saaus.
Quelle der Terraform-Konfiguration: Git
Git-Repository:
https://github.com/terraform-google-modules/terraform-google-networkGit-Verzeichnis:
modules/vpc
- Bereitstellungs-ID:
Klicken Sie auf Weiter.
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_idim 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_nameim Feld Wert den Wertquickstart-vpcein. Verwenden Sie keine Anführungszeichen.
Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .
- Geben Sie in der Zeile für den Schlüssel
Klicken Sie auf Vorschau erstellen.
Prüfen Sie auf der Detailseite für die Vorabversion
quickstart-preview-<var>UUID</var>, ob der Wert in der Zeile Status Erfolgreich ist.Klicken Sie auf Deployment erstellen, um ein Deployment mit den Werten aus der Vorschau zu erstellen.
Geben Sie im Feld Bereitstellungs-ID den Wert
quickstart-deploymentein.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:
Rufen Sie in der Google Cloud Console die Seite Infrastructure Manager auf.
Klicken Sie in der Spalte ID auf
quickstart-deployment.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:
Rufen Sie in der Google Cloud Console die Seite VPC-Netzwerke auf.
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.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:
Rufen Sie in der Google Cloud Console die Seite Build-Verlauf auf.
Suchen Sie in der Build-Tabelle nach dem neuesten Build mit der Region
us-central1. In dieser Liste werden Builds sowohl für diequickstart-preview-<var>UUID</var>-Vorschau als auch für dasquickstart-deployment-Deployment angezeigt.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:
Rufen Sie in der Google Cloud Console die Seite Infrastructure Manager auf.
Klicken Sie in der Spalte ID auf
quickstart-deployment.Klicken Sie auf der Detailseite der Bereitstellung auf Löschen.
Geben Sie im Bestätigungsdialogfeld
quickstart-deploymentein 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:
Rufen Sie in der Google Cloud Console die Seite Dienstkonten auf.
Klicken Sie auf das Kästchen für
im-quickstart-saund dann auf Löschen.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.
Wechseln Sie in der Google Cloud -Console zur Seite Ressourcen verwalten.
Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Beenden.
Nächste Schritte
- Funktionsweise von Infra Manager
- Weitere Informationen zu Terraform und Infra Manager
- Bereitstellung aktualisieren
- Bereitstellungen automatisieren.
- Eine Reihe von Konfigurationen und Modulen, die mitGoogle Cloudverwendet werden können, finden Sie in der Dokumentation zu Terraform in Google Cloud unter Terraform-Blueprints und -Module für Google Cloud.