Política de gerenciamento de versões do Terraform

O Infrastructure Manager usa versões específicas do Terraform para provisionar e gerenciar seus recursos Google Cloud . Para oferecer acesso a novos recursos e resolver vulnerabilidades de segurança, o Infra Manager atualiza periodicamente as versões disponíveis do Terraform.

Este documento descreve a política de gerenciamento do ciclo de vida dessas versões. A política de gerenciamento de versões do Terraform oferece um processo transparente e previsível para introduzir novas versões e descontinuar versões do Infra Manager.

Como a política funciona

O Infra Manager publica uma lista de versões disponíveis do Terraform e o status de suporte delas. Cada versão passa por um ciclo de vida que inclui disponibilidade, descontinuação e fim do suporte.

Esta tabela mostra as informações de descontinuação da versão do Terraform:

Versão do Terraform Data de lançamento Data da suspensão do uso Data de término do suporte Migrar automaticamente para a versão
1.2.3 21/08/2023 08/01/2026 08/02/2026 1.5.7
1.3.10 14/03/2024 A definir TBD A definir
1.4.7 14/03/2024 A definir TBD A definir
1.5.7 14/03/2024 A definir TBD TBD

As colunas na tabela representam o seguinte:

  • Versão do Terraform: o identificador da versão do Terraform.
  • Data de lançamento: a data em que a versão fica disponível no Infra Manager.
  • Data da suspensão de uso: a data em que a versão está programada para ser descontinuada. Depois dessa data, usar a versão para criar ou atualizar implantações vai gerar um aviso.

  • Data de fim do suporte: é a data em que a versão não vai mais receber suporte. Esse período termina 180 dias (ou mais) após a descontinuação.

  • Migração automática para a versão: a versão para a qual as implantações são migradas automaticamente após a data de fim do suporte (se você ativou a migração automática).

Para conferir a lista atual de versões compatíveis e as datas do ciclo de vida delas, consulte Versões compatíveis do Terraform.

Processo de suspensão de uso da versão

Quando uma versão do Terraform atinge a data de descontinuação, ela entra em um período de descontinuação antes da data de fim do suporte.

Quando uma versão é descontinuada:

  • A documentação pública é atualizada com a data de suspensão de uso e a data de fim do suporte.
  • Criar ou atualizar uma implantação ou prévia com a versão descontinuada retorna um aviso. Esse aviso informa que a versão está obsoleta e inclui a data de fim do suporte.

Depois que a data de fim do suporte de uma versão passa, ela é marcada como obsoleta. Se você tentar usar uma versão obsoleta para criar uma nova implantação, a operação vai falhar com um erro. Se você tentar atualizar uma implantação que faz referência a uma versão obsoleta, o comportamento vai depender da política de migração automática da sua organização.

Processo de disponibilidade de versão

Quando uma nova versão estável do Terraform fica disponível, ela é adicionada à lista de versões compatíveis. A nova versão do Terraform fica disponível para uso no console Google Cloud , na CLI gcloud e na API. A tabela de gerenciamento de versões é atualizada com a nova versão e a data de disponibilidade, e uma nota da versão do Infra Manager é criada.

Migração automática

Quando você atualiza uma implantação que usa uma versão sem suporte, o Infra Manager pode atualizar automaticamente a implantação para uma versão compatível. Esse recurso de migração automática é um processo de ativação que você configura com uma política da organização.

Se você não tiver ativado a migração automática, qualquer operação de atualização realizada em uma implantação que usa uma versão sem suporte vai falhar. Para continuar, modifique manualmente a configuração de implantação para especificar uma versão compatível e tente novamente a operação.

Configurar sua política de migração automática

É possível configurar a política de migração automática para versões do Terraform no Infra Manager usando a Google Cloud CLI.

Para ativar sua política de migração automática:

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

Para descrever sua política de migração automática:

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

A seguir