Per lavorare con Infrastructure Manager (Infra Manager), devi avere familiarità con Terraform. Per scoprire di più su Terraform, inizia con 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 entry point deve essere un modulo root 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 Moduli e progetti 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 | Livello di prezzo | Data disponibilità | Data di ritiro | Data di fine del supporto | Esegui la migrazione automatica alla versione |
|---|---|---|---|---|---|
1.2.3 |
Livello senza costi | 21/08/2023 | 8/01/2026 | 8/02/2026 | 1.5.7 |
1.3.10 |
Livello senza costi | 14/3/2024 | Da definire | Da definire | Da definire |
1.4.7 |
Livello senza costi | 14/3/2024 | Da definire | Da definire | Da definire |
1.5.7 |
Livello senza costi | 14/3/2024 | Da definire | Da definire | Da definire |
1.16.5 |
A pagamento | 2/11/2026 | Da definire | Da definire | Da definire |
Per informazioni sulle funzionalità introdotte in ogni release di Terraform, consulta la documentazione di HashiCorp Terraform e le release di Terraform.
Puoi specificare la versione di Terraform utilizzata da Infra Manager quando crei un deployment, aggiorni un deployment o visualizzi l'anteprima di un deployment nella consoleGoogle Cloud o utilizzando il flag --tf-version-constraint in gcloud CLI.
Se non specifichi una versione di Terraform durante la creazione di un nuovo deployment o di una nuova anteprima, Infra Manager utilizza per impostazione predefinita l'ultima versione del livello senza costi supportata (1.5.7). Per utilizzare una versione a pagamento (ad esempio 1.16.5), devi specificare esplicitamente il vincolo di versione.
Quando aggiorni un deployment, puoi eseguire l'upgrade a una versione di Terraform successiva, ma non puoi eseguire il downgrade a una versione supportata precedente. Per informazioni sul ritiro della versione di Terraform, consulta la documentazione relativa alla policy di gestione delle versioni di Terraform.
Per visualizzare la versione di Terraform utilizzata per creare un deployment o una revisione specifici, consulta Visualizza i dettagli di un deployment e Visualizza i dettagli di una revisione.
Licenze e prezzi per le versioni di Terraform
Le versioni di Terraform 1.5.7 e precedenti sono distribuite come open source con la Mozilla Public License (MPL 2.0) e sono disponibili nel Livello senza costi senza commissioni di gestione di Infra Manager.
La versione 1.16.5 di Terraform è distribuita con la Business Source License (BUSL) ed è offerta come versione a pagamento in Infra Manager. L'utilizzo di una versione di Terraform a pagamento comporta addebiti per il deployment e la gestione in base al numero di risorse gestite da Infra Manager:
Allocazione del Livello senza costi: ogni account di fatturazione riceve un'allocazione del Livello senza costi fino a 500 risorse al mese senza costi.
Addebiti per l'utilizzo: oltre alla quota mensile del Livello senza costi di 500 risorse, le risorse gestite dai deployment che utilizzano una versione di Terraform a pagamento comportano addebiti per la gestione delle risorse misurati su base oraria per risorsa.
Le anteprime non vengono addebitate: le versioni di Terraform a pagamento (come
1.16.5) comportano addebiti solo per i deployment di Infra Manager, non per le anteprime dei deployment.
Per ulteriori informazioni sui prezzi, consulta Prezzi di Infrastructure Manager.
Vincoli sulle 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 saperne di più, consulta Valori di configurazione di Terraform e dati sensibili.
- Devi fornire un modulo root 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.
- Sconsigliamo l'utilizzo di provisioner. Se possibile, utilizza una soluzione diversa. Per saperne di più su questo suggerimento, consulta Provisioners are a Last Resort. 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 sensibili o che consentono l'identificazione personale nei valori di configurazione di Terraform.
La documentazione del provider Google Cloud indica i valori di configurazione che possono potenzialmente 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 è contrassegnato come sensibile nella pagina google_storage_bucket_object della documentazione del provider Google Cloud .
Puoi utilizzare queste etichette come guida durante la creazione di configurazioni Terraform o durante la revisione di una configurazione Terraform esistente prima dell'uso.
Consulta l'Informativa sulla privacy diGoogle Cloud 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
Facoltativamente, puoi utilizzare gcloud CLI per configurare deployment e anteprime in modo da utilizzare 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 Esegui il deployment dell'infrastruttura utilizzando Infrastructure Manager, Aggiorna un deployment o Visualizza l'anteprima di un deployment.
Controlla le versioni supportate del provider
Per controllare le versioni di un provider Terraform per Google Cloud supportate da Infra Manager, visualizza il manifest.json nel bucket Cloud Storage gestito da Infra Manager associato alla regione del tuo 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 tuo 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.
- Elimina un deployment.