Esegui il deployment di un VPC con Terraform
Puoi eseguire il deployment di una rete Virtual Private Cloud (VPC) utilizzando Infrastructure Manager e la consoleGoogle Cloud . Questa guida rapida è rivolta ad amministratori cloud, platform engineer e sviluppatori che vogliono gestire l'infrastructure as code di Google Cloud . Una rete VPC fornisce un networking isolato per risorse come istanze di macchine virtuali (VM), database e app.
Con Infra Manager, definisci la rete in una configurazione Terraform anziché crearla manualmente. Infra Manager esegue Terraform per te e archivia lo stato di Terraform. Di conseguenza, puoi riprodurre, aggiornare ed eliminare la tua infrastruttura in modo coerente. Per saperne di più, consulta Panoramica di Terraform su Google Cloud.
In questa guida rapida, visualizzerai l'anteprima e creerai un deployment da una configurazione Terraform in un repository GitHub pubblico.
Prima di iniziare
-
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.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per completare questa guida rapida, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:
- Cloud Infrastructure Manager Admin (
roles/config.admin) - Amministratore Service Account (
roles/iam.serviceAccountAdmin) - Utente Service Account (
roles/iam.serviceAccountUser) - Project IAM Admin (
roles/resourcemanager.projectIamAdmin) - Compute Network Viewer (
roles/compute.networkViewer) - Cloud Build Viewer (
roles/cloudbuild.builds.viewer) - Storage Object Viewer (
roles/storage.objectViewer)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Visualizza l'anteprima e crea un deployment
Quando crei un deployment, Infra Manager esegue il provisioning delle risorse definite nella configurazione Terraform. Prima di creare il deployment, crei un'anteprima per verificare di quali risorse Infra Manager pianifica il provisioning.
Per visualizzare l'anteprima e creare un deployment che esegue il provisioning di una rete VPC, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Infrastructure Manager.
Fai clic su Crea nuovo deployment.
Nella pagina Crea nuovo deployment Terraform, nella sezione Dettagli deployment, inserisci i seguenti valori:
- ID deployment:
quickstart-preview - Regione:
us-central1 - Versione di Terraform:
1.5.7 Service account: crea un nuovo account di servizio denominato
im-quickstart-sa. Per creare il account di servizio e concedergli i ruoli richiesti, segui questi passaggi:- Nell'elenco Service account, fai clic su Nuovo service account. La pagina Crea service account si apre in una nuova scheda.
- Nel campo Nome service account, inserisci
im-quickstart-sa, quindi fai clic su Crea e continua. Nella sezione Concedi a questo account di servizio l'accesso al progetto, utilizza l'elenco Seleziona un ruolo per concedere i seguenti ruoli. Per aggiungere il secondo ruolo, fai clic su Aggiungi un altro ruolo.
- Cloud Infrastructure Manager Agent (
roles/config.agent): consente a Infra Manager di eseguire Terraform e archiviare lo stato e i log del deployment. - Compute Network Admin (
roles/compute.networkAdmin): consente a Infra Manager di creare e gestire la rete VPC.
Per saperne di più sui ruoli di Infra Manager, consulta Controllo degli accessi con IAM.
- Cloud Infrastructure Manager Agent (
Fai clic su Continua e poi su Fine.
Chiudi la scheda e torna alla pagina Crea nuovo deployment Terraform.
Nell'elenco Service account, fai clic su Aggiorna elenco, quindi seleziona
im-quickstart-sa.
Origine della configurazione Terraform: Git
Repository Git:
https://github.com/terraform-google-modules/terraform-google-networkDirectory Git:
modules/vpc
- ID deployment:
Fai clic su Continua.
Nella sezione Dettagli Terraform, in Valori di input, inserisci i seguenti valori per le variabili del modulo precompilate:
- Nella riga della chiave
project_id, nel campo Valore, inserisci<var>PROJECT_ID</var>. Non includere le virgolette. - Nella riga della chiave
network_name, nel campo Valore, inserisciquickstart-vpc. Non includere le virgolette.
Sostituisci PROJECT_ID con l'ID progetto Google Cloud .
- Nella riga della chiave
Fai clic su Crea anteprima.
Nella pagina dei dettagli dell'anteprima di
quickstart-preview-<var>UUID</var>, verifica che il valore nella riga Stato sia Riuscito.Per creare un deployment che utilizzi i valori dell'anteprima, fai clic su Crea deployment.
Nel campo ID deployment, inserisci
quickstart-deployment.Fai clic su Crea deployment.
Infra Manager esegue il provisioning della rete VPC. Al termine del deployment, riceverai una notifica nella console Google Cloud .
Hai creato un deployment utilizzando Infra Manager. Nelle sezioni seguenti verificherai il deployment, visualizzerai la rete di cui è stato eseguito il provisioning ed esaminerai il job Cloud Build che ha eseguito Terraform.
Visualizza lo stato del deployment
Dopo che Infra Manager ha creato il deployment, puoi visualizzarne i dettagli, ad esempio lo stato, l'ultima revisione e l'origine della configurazione Terraform.
Per visualizzare i dettagli del deployment:
Nella console Google Cloud , vai alla pagina Infrastructure Manager.
Nella colonna ID, fai clic su
quickstart-deployment.Nella pagina dei dettagli del deployment, verifica che il valore nella riga Stato sia Attivo.
Visualizza la rete VPC di cui è stato eseguito il provisioning
Per confermare che Infra Manager ha eseguito il provisioning della rete definita dalla configurazione Terraform, visualizza la rete nella console Google Cloud :
Nella console Google Cloud , vai alla pagina Reti VPC.
L'elenco delle reti include
quickstart-vpc, ovvero la rete di cui Infra Manager ha eseguito il provisioning. L'elenco mostra i dettagli della rete, ad esempio la modalità di creazione delle subnet, l'unità massima di trasmissione (MTU) e la modalità di routing dinamico.Per visualizzare ulteriori dettagli sulla rete, come subnet, regole firewall e route, fai clic su
quickstart-vpc.
Visualizza i risultati della build in Cloud Build
Infra Manager utilizza Cloud Build per eseguire Terraform per ogni revisione del deployment. Per esaminare i comandi Terraform che hanno creato il tuo deployment o per risolvere i problemi di un deployment non riuscito, visualizza i log di build di Cloud Build:
Nella console Google Cloud , vai alla pagina Cronologia build.
Nella tabella delle build, individua la build più recente con la regione
us-central1. In questo elenco vengono visualizzate le build sia per l'anteprimaquickstart-preview-<var>UUID</var>sia per il deploymentquickstart-deployment.Fai clic sull'ID build per aprire la pagina Dettagli build.
La pagina Dettagli build mostra lo stato di ogni passaggio della build e il log della build, che include l'output dei comandi Terraform. Se un deployment non riesce, utilizza il log di build per identificare la causa. Per saperne di più, consulta Risolvi gli errori di deployment.
Puoi anche aprire la build per un deployment dalla pagina dei dettagli del deployment in Infra Manager facendo clic sul link Log di Cloud Build.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa guida rapida, elimina il deployment quando non ne hai più bisogno. Le anteprime dei deployment non comportano addebiti sul tuo account Google Cloud . Se vuoi eliminare l'anteprima, consulta Elimina le anteprime.
Elimina il deployment
Elimina il deployment e la rete VPC di cui è stato eseguito il provisioning:
Per eliminare il deployment:
Nella console Google Cloud , vai alla pagina Infrastructure Manager.
Nella colonna ID, fai clic su
quickstart-deployment.Nella pagina dei dettagli del deployment, fai clic su Elimina.
Nella finestra di dialogo di conferma, inserisci
quickstart-deployment, quindi fai clic su Conferma.
Elimina l'account di servizio
Dopo che Infra Manager ha eliminato il deployment, elimina il account di servizio im-quickstart-sa in modo che non mantenga i suoi ruoli nel progetto:
Nella Google Cloud console, vai alla pagina Service account.
Seleziona la casella di controllo relativa a
im-quickstart-sa, quindi fai clic su Elimina.Nella finestra di dialogo, fai clic su Elimina.
(Facoltativo) Elimina il progetto
Se hai creato il deployment in un nuovo progetto Google Cloud e non ne hai più bisogno, eliminalo.
Nella console Google Cloud , vai alla pagina Gestisci risorse.
Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
Nella finestra di dialogo, inserisci l'ID progetto, quindi fai clic su Chiudi.
Passaggi successivi
- Scopri come funziona Infra Manager.
- Scopri di più su Terraform e Infra Manager.
- Aggiorna un deployment.
- Automatizza i deployment.
- Per un insieme di configurazioni e moduli pronti per l'uso con Google Cloud, consulta Moduli e progetti base Terraform per Google Cloud nella documentazione di Terraform su Google Cloud .