O Infrastructure Manager usa versões específicas do Terraform para aprovisionar e gerir os seus Google Cloud recursos. Para fornecer acesso a novas funcionalidades e resolver vulnerabilidades de segurança, o Infra Manager atualiza periodicamente as versões do Terraform disponíveis.
Este documento descreve a política de gestão do ciclo de vida destas versões. A política de gestão 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 funciona a política
O Infra Manager publica uma lista das versões do Terraform disponíveis e o respetivo estado de apoio técnico. Cada versão progride ao longo de um ciclo de vida que inclui a disponibilidade, a descontinuação e o fim do apoio técnico.
Esta tabela mostra as informações de descontinuação da versão do Terraform:
| Versão do Terraform | Data disponível | Data de descontinuação | Data de fim do apoio técnico | Migre automaticamente para a versão |
|---|---|---|---|---|
1.2.3 |
21/08/2023 | 08/01/2026 | 08/02/2026 | 1.5.7 |
1.3.10 |
14/3/2024 | A determinar | A determinar | A determinar |
1.4.7 |
14/3/2024 | A determinar | A determinar | A determinar |
1.5.7 |
14/3/2024 | A determinar | A determinar | A determinar |
As colunas na tabela representam o seguinte:
- Versão do Terraform: o identificador da versão do Terraform.
- Data de disponibilidade: a data em que a versão fica disponível no Infra Manager.
- Data de descontinuação: a data em que a versão está agendada para descontinuação. Após esta data, a utilização da versão para criar ou atualizar implementações gera um aviso.
Data de fim do suporte: a data em que a versão deixa de ser suportada. Este 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 implementações são migradas automaticamente após a data de fim do apoio técnico (se tiver ativado a migração automática).
Para ver a lista atual de versões suportadas e as respetivas datas do ciclo de vida, consulte o artigo Versões do Terraform suportadas.
Processo de descontinuação de versões
Quando uma versão do Terraform atinge a data de descontinuação, entra num período de descontinuação antes da data de fim do apoio técnico.
Quando uma versão é descontinuada:
- A documentação pública é atualizada com a Data de descontinuação e a Data de fim do apoio técnico.
- A criação ou a atualização de uma implementação ou uma pré-visualização com a versão descontinuada devolve um aviso. Este aviso indica que a versão está descontinuada e inclui a data de fim do apoio técnico.
Após a data de fim do apoio técnico de uma versão, esta é marcada como obsoleta. Se tentar usar uma versão obsoleta para criar uma nova implementação, a operação falha com um erro. Se tentar atualizar uma implementação existente que faça referência a uma versão obsoleta, o comportamento depende da política de migração automática da sua organização.
Processo de disponibilidade de versões
Quando uma nova versão estável do Terraform está disponível, é adicionada à lista de versões suportadas. A nova versão do Terraform fica disponível para utilização na Google Cloud consola, na CLI gcloud e na API. A tabela de gestão de versões é atualizada com a nova versão e a respetiva data de disponibilidade, e é criada uma nota de lançamento do Infra Manager.
Migração automática
Quando atualiza uma implementação existente que usa uma versão não suportada, o Infra Manager pode atualizar automaticamente a implementação para uma versão suportada. Esta funcionalidade de migração automática é um processo de ativação que configura através de uma política da organização.
Se não tiver ativado a migração automática, qualquer operação de atualização que realizar numa implementação que use uma versão não suportada vai falhar. Para continuar, tem de modificar manualmente a configuração de implementação para especificar uma versão suportada e, em seguida, repetir a operação.
Configure a política de migração automática
Pode configurar a política de migração automática para versões do Terraform no Infra Manager através da CLI Google Cloud.
Para ativar a política de migração automática:
gcloud infra-manager automigrationconfig enable-auto-migration --project=PROJECT_ID --location=LOCATION
Para descrever a sua política de migração automática:
gcloud infra-manager automigrationconfig describe --project=PROJECT_ID --location=LOCATION
O que se segue?
- Para ver a lista atual de versões suportadas e as respetivas datas do ciclo de vida, consulte o artigo Versões do Terraform suportadas.