Esegui il provisioning delle risorse Config Sync con Terraform
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
HashiCorp Terraform è uno strumento Infrastructure as Code (IaC) che consente
di eseguire il provisioning e di gestire l'infrastruttura cloud. Terraform fornisce plug-in noti con il nome
provider che ti consentono di interagire con i provider cloud e altre API. Puoi
utilizzare il provider Terraform per Google Cloud per eseguire il provisioning e gestire
le risorse Google Cloud , incluso Config Sync.
Questa pagina introduce l'utilizzo di Terraform con Config Sync, inclusa un'introduzione
al funzionamento di Terraform e alcune risorse per iniziare a utilizzare Terraform
con Google Cloud. Troverai anche link alla documentazione di riferimento di Terraform per
Config Sync, esempi di codice e guide per l'utilizzo di Terraform
per il provisioning delle risorse Config Sync.
Terraform ha una sintassi dichiarativa e orientata alla configurazione che puoi
utilizzare per descrivere l'infrastruttura di cui vuoi eseguire il provisioning nel tuo
progetto Google Cloud . Dopo aver creato questa configurazione in uno o più
file di configurazione Terraform, puoi utilizzare Terraform CLI per applicarla
alle risorse Config Sync.
I passaggi seguenti spiegano come funziona Terraform:
Puoi descrivere l'infrastruttura di cui vuoi eseguire il provisioning in un file di configurazione
Terraform. Non è necessario scrivere codice che descriva
come eseguire il provisioning dell'infrastruttura. Terraform esegue il provisioning dell'infrastruttura per conto tuo.
Puoi eseguire il comando terraform plan, che valuta la configurazione e
genera un piano di esecuzione. Puoi anche rivedere il piano e apportare le modifiche
necessarie.
Puoi eseguire il comando terraform apply che:
Esegue il provisioning dell'infrastruttura in base al piano di esecuzione richiamando
le API Config Sync corrispondenti in background.
Crea un file di stato Terraform, ovvero un file JSON che mappa le risorse
nel tuo file di configurazione alle risorse nell'infrastruttura reale. Terraform utilizza
questo file per tenere traccia dello stato più recente dell'infrastruttura e per determinare
quando creare, aggiornare ed eliminare le risorse.
Quando esegui terraform apply, Terraform utilizza la mappatura nel
file di stato per confrontare l'infrastruttura esistente con il codice e apportare
gli aggiornamenti necessari:
Se un oggetto della risorsa è definito nel file di configurazione, ma non esiste nel
file dello stato, Terraform lo crea.
Se nel file dello stato esiste un oggetto della risorsa,
ma la sua configurazione è diversa da quella del file di configurazione, Terraform aggiorna la risorsa
in modo che corrisponda al file di configurazione.
Se un oggetto della risorsa nel file dello stato corrisponde al tuo file di configurazione,
Terraform lascia la risorsa invariata.
Risorse Terraform per Config Sync
Le risorse sono gli elementi fondamentali del linguaggio Terraform. Ogni
blocco di risorse descrive uno o più oggetti di infrastruttura, come reti virtuali o istanze di computing.
La tabella seguente elenca le risorse Terraform disponibili per
Config Sync:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[],[],null,["# Provision Config Sync resources with Terraform\n\nHashiCorp Terraform is an infrastructure-as-code (IaC) tool that lets you\nprovision and manage cloud infrastructure. Terraform provides plugins called\n*providers* that let you interact with cloud providers and other APIs. You can\nuse the *Terraform provider for Google Cloud* to provision and manage\nGoogle Cloud resources, including Config Sync.\n\nThis page introduces you to using Terraform with Config Sync, including an\nintroduction to how Terraform works and some resources to help you get started using\nTerraform with Google Cloud. You'll also find links to Terraform reference docs for\nConfig Sync, code examples, and guides for using Terraform to provision\nConfig Sync resources.\n\nFor instructions on how to get started with Terraform for Google Cloud, see\n[Install and configure Terraform](/docs/terraform/install-configure-terraform) or the\n[Terraform for Google Cloud quickstart](/docs/terraform/create-vm-instance).\n\nHow Terraform works\n-------------------\n\nTerraform has a declarative and configuration-oriented syntax, which you can\nuse to describe the infrastructure that you want to provision in your\nGoogle Cloud project. After you author this configuration in one or more\nTerraform configuration files, you can use the Terraform CLI to apply this\nconfiguration to your Config Sync resources.\n\nThe following steps explain how Terraform works:\n\n1. You describe the infrastructure you want to provision in a *Terraform\n configuration file*. You don't need to write code describing how to provision the infrastructure. Terraform provisions the infrastructure for you.\n2. You run the `terraform plan` command, which evaluates your configuration and generates an execution plan. You can review the plan and make changes as needed.\n3. You run the `terraform apply` command, which performs the following\n actions:\n\n 1. It provisions your infrastructure based on your execution plan by invoking the corresponding Config Sync APIs in the background.\n 2. It creates a *Terraform state file*, which is a JSON file that maps the resources in your configuration file to the resources in the real-world infrastructure. Terraform uses this file to keep a record of the most recent state of your infrastructure, and to determine when to create, update, and destroy resources.\n 3. When you run `terraform apply`, Terraform uses the mapping in\n the state file to compare the existing infrastructure to the code, and make\n updates as necessary:\n\n - If a resource object is defined in the configuration file, but doesn't exist in the state file, Terraform creates it.\n - If a resource object exists in the state file, but has a different configuration from your configuration file, Terraform updates the resource to match your configuration file.\n - If a resource object in the state file matches your configuration file, Terraform leaves the resource unchanged.\n\nTerraform resources for Config Sync\n-----------------------------------\n\n*Resources* are the fundamental elements in the Terraform language. Each\nresource block describes one or more infrastructure objects, such as virtual\nnetworks or compute instances.\n\nThe following table lists the Terraform resources available for\nConfig Sync:\n\n\n\u003cbr /\u003e\n\nTerraform-based guides for Config Sync\n--------------------------------------\n\nThe following table lists Terraform-based how-to guides and tutorials for\nConfig Sync:\n\n\n\u003cbr /\u003e\n\nWhat's next\n-----------\n\n- [Terraform code samples for Config Sync](/docs/samples?language=terraform)\n- [Terraform on Google Cloud documentation](/docs/terraform)\n- [Google Cloud provider documentation in HashiCorp](https://registry.terraform.io/providers/hashicorp/google/latest/docs)\n- [Infrastructure as code for Google Cloud](/docs/terraform/iac-overview)"]]
