Per utilizzare Infrastructure Manager (Infra Manager), devi avere familiarità con Terraform. Per scoprire di più su Terraform, inizia da Che cos'è Terraform?.
Infra Manager esegue il deployment delle risorse e delle configurazioni dell'infrastruttura definite in una configurazione Terraform. Queste configurazioni possono essere composte da più file e directory, ma il loro punto di ingresso deve essere un modulo principale di Terraform.
Infra Manager utilizza il termine blueprint per fare riferimento a una configurazione Terraform.
Per scoprire di più su Terraform con Google Cloud, consulta Terraform su Google Cloud.
Moduli Terraform per Google Cloud
Per un insieme di moduli per il provisioning delle risorse Google Cloud , consulta Modelli e moduli Terraform per Google Cloud.
Puoi anche creare i tuoi moduli Terraform per Google Cloud. Per maggiori dettagli, consulta Creazione di moduli.
Versioni di Terraform supportate
Infrastructure Manager supporta le seguenti versioni di Terraform:
- Versione Terraform 1.2.3
- Versione 1.3.10 di Terraform
- Terraform versione 1.4.7
- Terraform versione 1.5.7
Puoi utilizzare il flag --tf-version-constraint per specificare la versione di
Terraform che Infra Manager utilizza per
creare un deployment.
Se non specifichi una versione di Terraform, viene utilizzata per impostazione predefinita l'ultima versione supportata.
Quando aggiorni un deployment, puoi modificare la versione di Terraform con una versione successiva di Terraform. Non puoi passare a una versione precedente supportata di Terraform.
Per visualizzare la versione di Terraform utilizzata per creare un deployment o una revisione specifici, consulta Visualizzare i dettagli di un deployment e Visualizzare i dettagli di una revisione.
Vincoli per le configurazioni Terraform
Per utilizzare Infrastructure Manager per eseguire il deployment di una configurazione Terraform, la configurazione presenta i seguenti vincoli.
- Non includere informazioni personali o sensibili nei valori di configurazione di Terraform. Per saperne di più, consulta la sezione Valori di configurazione di Terraform e dati sensibili.
- È necessario fornire un modulo principale Terraform valido. La creazione di modelli o la generazione di Terraform non è supportata.
- La configurazione deve essere attivabile da una versione supportata di Terraform.
- I blocchi di backend non devono essere definiti.
- L'utilizzo di provisioner non è consigliato. Se possibile, utilizza una soluzione diversa. Per ulteriori dettagli sui provisioner, consulta la sezione I provisioner sono un'ultima risorsa. Se utilizzi i provisioner, tieni presente che l'ambiente di runtime di Infra Manager può cambiare in qualsiasi momento.
Valori di configurazione Terraform e dati sensibili
Non includere informazioni personali o sensibili nei valori di configurazione di Terraform.
La documentazione del Google Cloud provider indica i valori di configurazione che potrebbero includere informazioni sensibili.
Ad esempio, la risorsa google_storage_bucket_object consente
la creazione di un oggetto Cloud Storage utilizzando l'argomento content. Questo
argomento è etichettato come sensibile nella
pagina google_storage_bucket_object della Google Cloud documentazione del fornitore.
Puoi utilizzare queste etichette come guida durante la creazione delle configurazioni Terraform o durante la revisione di una configurazione Terraform esistente prima dell'utilizzo.
Consulta l'Google Cloud Informativa sulla privacy per informazioni su come Google Cloud tratta le informazioni personali che raccoglie o genera durante la fornitura e l'amministrazione dei Servizi Cloud.
Utilizza il provider Terraform per Google Cloud
Puoi configurare i deployment e le anteprime in modo che utilizzino i provider Terraform gestiti da Infra Manager per Google Cloud.
Questo campo facoltativo ti consente di specificare l'utilizzo dei provider Terraform gestiti da Infra Manager per creare o aggiornare un deployment o visualizzarne l'anteprima. Puoi specificare un provider Terraform utilizzando gcloud CLI.
Infra Manager supporta i provider Terraform per Google Cloud:
googlegoogle-beta
Ometti questo campo per utilizzare il provider Terraform gestito da HashiCorp per Google Cloud.
Per scoprire come specificare l'utilizzo di un provider Terraform gestito da Infra Manager, consulta Eseguire il deployment dell'infrastruttura utilizzando Infrastructure Manager, Aggiornare un deployment o Visualizzare l'anteprima di un deployment.
Controllare le versioni supportate del fornitore
Per controllare le versioni di un provider Terraform per Google Cloud che
Infra Manager supporta, devi visualizzare il
manifest.json nel bucket Cloud Storage gestito da Infra Manager
associato alla regione del deployment nel formato:
https://storage.googleapis.com/LOCATION-im-providers/hashicorp/PROVIDER_VERSION/manifest.json
Puoi trovare un elenco completo delle versioni supportate
nel campo versions del file manifest.json.
Ad esempio, se il deployment si trova nella regione africa-south1 e utilizzi il provider google-beta, vai all'indirizzo https://storage.googleapis.com/africa-south1-im-providers/hashicorp/google-beta/manifest.json per visualizzare le regioni disponibili.
Passaggi successivi
- Scopri di più su Infrastructure Manager.
- Creare un deployment.
- Aggiorna un deployment.
- Visualizza lo stato di un deployment.
- Eliminare un deployment.