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 , vedi Progetti 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
Infra Manager supporta le seguenti versioni di Terraform:
| Versione Terraform | Data disponibilità | Data di ritiro | Data di fine del supporto | Esegui la migrazione automatica alla versione |
|---|---|---|---|---|
1.2.3 |
21/08/2023 | 8/1/2026 | 8/2/2026 | 1.5.7 |
1.3.10 |
14/03/2024 | Da definire | Da definire | Da definire |
1.4.7 |
14/03/2024 | Da definire | Da definire | Da definire |
1.5.7 |
14/03/2024 | Da definire | Da definire | Da definire |
Puoi utilizzare il flag --tf-version-constraint per specificare la versione di
Terraform che Infra Manager utilizza per
creare un deployment.
Prima di utilizzare Infrastructure Manager per eseguire il deployment di una configurazione Terraform, assicurati che la configurazione abbia i seguenti vincoli:
Se non specifichi una versione di Terraform, viene utilizzata per impostazione predefinita l'ultima versione supportata.
Quando aggiorni un deployment, puoi eseguire l'upgrade a una versione successiva di Terraform, ma non puoi eseguire il downgrade a una versione precedente supportata. Per informazioni sul ritiro della versione di Terraform, consulta la documentazione relativa alle norme di gestione delle versioni 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 deve rispettare i seguenti vincoli:
- Non includere informazioni sensibili o che consentono l'identificazione personale nei valori di configurazione di Terraform. Per maggiori informazioni, consulta Valori di configurazione di Terraform e dati sensibili.
- È necessario fornire un modulo radice 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.
- Non consigliamo di utilizzare i provisioner. Se possibile, utilizza una soluzione diversa. Per saperne di più su questo consiglio, consulta I provisioner sono l'ultima risorsa. Se utilizzi i provisioner, tieni presente che l'ambiente runtime di Infra Manager può cambiare in qualsiasi momento.
Valori di configurazione Terraform e dati sensibili
Non includere informazioni sensibili o che consentono l'identificazione personale 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'uso.
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
Se vuoi, puoi utilizzare gcloud CLI per configurare le implementazioni e le anteprime in modo che utilizzino i provider Terraform gestiti da Infra Manager perGoogle Cloud.
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.
Controlla le versioni supportate del fornitore
Per controllare le versioni di un provider Terraform che Google Cloud Infra Manager supporta, visualizza 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 a
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.
- Crea un deployment.
- Aggiorna un deployment.
- Visualizza lo stato di un deployment.
- Eliminare un deployment.