Policy di gestione delle versioni di Terraform

Infrastructure Manager utilizza versioni specifiche di Terraform per eseguire il provisioning e gestire le tue risorse Google Cloud . Per fornire l'accesso a nuove funzionalità e risolvere le vulnerabilità di sicurezza, Infra Manager aggiorna periodicamente le versioni di Terraform disponibili.

Questo documento descrive le norme per la gestione del ciclo di vita di queste versioni. La norma di gestione delle versioni di Terraform fornisce un processo trasparente e prevedibile per l'introduzione di nuove versioni e il ritiro di versioni per Infra Manager.

Come funzionano le norme

Infrastructure Manager pubblica un elenco delle versioni di Terraform disponibili e il relativo stato di supporto. Ogni versione segue un ciclo di vita che include disponibilità, ritiro e fine dell'assistenza.

Questa tabella mostra le informazioni sul ritiro della versione 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

Le colonne della tabella rappresentano quanto segue:

  • Versione Terraform: l'identificatore della versione di Terraform.
  • Data disponibilità: la data in cui la versione diventa disponibile in Infra Manager.
  • Data di ritiro: la data in cui è pianificato il ritiro della versione. Dopo questa data, l'utilizzo della versione per creare o aggiornare i deployment genera un avviso.

  • Data di fine del supporto: la data in cui la versione non è più supportata. Questo periodo termina 180 giorni (o più) dopo il ritiro.

  • Esegui la migrazione automatica alla versione: la versione a cui vengono eseguite automaticamente le migrazioni dei deployment dopo la data di fine del supporto (se hai attivato la migrazione automatica).

Per visualizzare l'elenco attuale delle versioni supportate e le relative date del ciclo di vita, consulta Versioni di Terraform supportate.

Procedura di ritiro delle versioni

Quando una versione di Terraform raggiunge la data di ritiro, inizia un periodo di ritiro prima della data di fine del supporto.

Quando una versione viene ritirata:

  • La documentazione pubblica viene aggiornata con la data di ritiro e la data di fine del supporto.
  • La creazione o l'aggiornamento di un deployment o di un'anteprima con la versione deprecata restituisce un avviso. Questo avviso indica che la versione è deprecata e include la data di fine del supporto.

Una volta superata la data di fine del supporto di una versione, questa viene contrassegnata come obsoleta. Se tenti di utilizzare una versione obsoleta per creare una nuova implementazione, l'operazione non andrà a buon fine e verrà visualizzato un errore. Se tenti di aggiornare un deployment esistente che fa riferimento a una versione obsoleta, il comportamento dipende dalle norme della tua organizzazione per la migrazione automatica.

Procedura di disponibilità delle versioni

Quando è disponibile una nuova versione stabile di Terraform, questa viene aggiunta all'elenco delle versioni supportate. La nuova versione di Terraform diventa disponibile per l'utilizzo nella console Google Cloud , in gcloud CLI e nell'API. La tabella di gestione delle versioni viene aggiornata con la nuova versione e la relativa data di disponibilità e viene creata una nota di rilascio di Infra Manager.

Migrazione automatica

Quando aggiorni un deployment esistente che utilizza una versione non supportata, Infra Manager può aggiornare automaticamente il deployment a una versione supportata. Questa funzionalità di migrazione automatica è un processo di attivazione che configuri tramite un criterio dell'organizzazione.

Se non hai attivato la migrazione automatica, qualsiasi operazione di aggiornamento eseguita su un deployment che utilizza una versione non supportata non andrà a buon fine. Per procedere, devi modificare manualmente la configurazione del deployment per specificare una versione supportata e poi riprovare l'operazione.

Configura la policy di migrazione automatica

Puoi configurare la policy di migrazione automatica per le versioni di Terraform su Infra Manager utilizzando Google Cloud CLI.

Per attivare la policy di migrazione automatica:

gcloud infra-manager automigrationconfig enable-auto-migration --project=PROJECT_ID --location=LOCATION

Per descrivere le tue norme di migrazione automatica:

gcloud infra-manager automigrationconfig describe --project=PROJECT_ID --location=LOCATION

Passaggi successivi