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

  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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare questa guida rapida, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

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:

  1. Nella console Google Cloud , vai alla pagina Infrastructure Manager.

    Vai a Infrastructure Manager

  2. Fai clic su Crea nuovo deployment.

  3. 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:

      1. Nell'elenco Service account, fai clic su Nuovo service account. La pagina Crea service account si apre in una nuova scheda.
      2. Nel campo Nome service account, inserisci im-quickstart-sa, quindi fai clic su Crea e continua.
      3. 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.

      4. Fai clic su Continua e poi su Fine.

      5. Chiudi la scheda e torna alla pagina Crea nuovo deployment Terraform.

      6. 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-network

    • Directory Git: modules/vpc

  4. Fai clic su Continua.

  5. 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, inserisci quickstart-vpc. Non includere le virgolette.

    Sostituisci PROJECT_ID con l'ID progetto Google Cloud .

  6. Fai clic su Crea anteprima.

  7. Nella pagina dei dettagli dell'anteprima di quickstart-preview-<var>UUID</var>, verifica che il valore nella riga Stato sia Riuscito.

  8. Per creare un deployment che utilizzi i valori dell'anteprima, fai clic su Crea deployment.

  9. Nel campo ID deployment, inserisci quickstart-deployment.

  10. 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:

  1. Nella console Google Cloud , vai alla pagina Infrastructure Manager.

    Vai a Infrastructure Manager

  2. Nella colonna ID, fai clic su quickstart-deployment.

  3. 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 :

  1. Nella console Google Cloud , vai alla pagina Reti VPC.

    Vai a 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.

  2. 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:

  1. Nella console Google Cloud , vai alla pagina Cronologia build.

    Vai alla cronologia delle build

  2. Nella tabella delle build, individua la build più recente con la regione us-central1. In questo elenco vengono visualizzate le build sia per l'anteprima quickstart-preview-<var>UUID</var> sia per il deployment quickstart-deployment.

  3. 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:

  1. Nella console Google Cloud , vai alla pagina Infrastructure Manager.

    Vai a Infrastructure Manager

  2. Nella colonna ID, fai clic su quickstart-deployment.

  3. Nella pagina dei dettagli del deployment, fai clic su Elimina.

  4. 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:

  1. Nella Google Cloud console, vai alla pagina Service account.

    Vai ad Account di servizio

  2. Seleziona la casella di controllo relativa a im-quickstart-sa, quindi fai clic su Elimina.

  3. 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.

  1. Nella console Google Cloud , vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

  2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.

  3. Nella finestra di dialogo, inserisci l'ID progetto, quindi fai clic su Chiudi.

Passaggi successivi