Règlement sur la gestion des versions Terraform

Infrastructure Manager utilise des versions spécifiques de Terraform pour provisionner et gérer vos ressources Google Cloud . Pour donner accès à de nouvelles fonctionnalités et corriger les failles de sécurité, Infra Manager met à jour régulièrement les versions de Terraform disponibles.

Ce document décrit la stratégie de gestion du cycle de vie de ces versions. La règle de gestion des versions Terraform fournit un processus transparent et prévisible pour l'introduction de nouvelles versions et l'abandon de versions pour Infra Manager.

Fonctionnement du règlement

Infrastructure Manager publie une liste des versions Terraform disponibles et de leur état de compatibilité. Chaque version passe par un cycle de vie qui comprend la disponibilité, l'abandon et la fin de la compatibilité.

Ce tableau présente les informations sur l'obsolescence des versions de Terraform :

Version Terraform Date de disponibilité Début de la période d'abandon Date de fin d'assistance Migrer automatiquement vers la version
1.2.3 21/08/2023 08/01/2026 08/02/2026 1.5.7
1.3.10 14/03/2024 À déterminer TBD À déterminer
1.4.7 14/03/2024 À déterminer TBD À déterminer
1.5.7 14/03/2024 À déterminer TBD À déterminer

Les colonnes du tableau représentent les éléments suivants :

  • Version Terraform : identifiant de la version Terraform.
  • Date de disponibilité : date à laquelle la version devient disponible dans Infra Manager.
  • Date d'abandon : date à laquelle la version doit être abandonnée. Après cette date, l'utilisation de la version pour créer ou mettre à jour des déploiements génère un avertissement.

  • Date de fin de l'assistance : date à laquelle la version ne sera plus prise en charge. Cette période se termine 180 jours (ou plus) après l'arrêt.

  • Migrer automatiquement vers la version : version vers laquelle les déploiements sont automatiquement migrés après la date de fin de la prise en charge (si vous avez activé la migration automatique).

Pour consulter la liste actuelle des versions compatibles et leurs dates de cycle de vie, consultez Versions Terraform compatibles.

Processus d'abandon de version

Lorsqu'une version de Terraform atteint sa date d'abandon, elle entre dans une période d'abandon avant sa date de fin du support.

Lorsqu'une version est obsolète :

  • La documentation publique est mise à jour avec la date d'abandon et la date de fin de prise en charge.
  • La création ou la mise à jour d'un déploiement ou d'un aperçu avec la version obsolète renvoie un avertissement. Cet avertissement indique que la version est obsolète et inclut la date de fin de la compatibilité.

Une fois la date de fin de prise en charge d'une version dépassée, celle-ci est marquée comme obsolète. Si vous essayez d'utiliser une version obsolète pour créer un déploiement, l'opération échouera et une erreur s'affichera. Si vous tentez de mettre à jour un déploiement existant qui fait référence à une version obsolète, le comportement dépend de la règle de votre organisation concernant la migration automatique.

Processus de disponibilité des versions

Lorsqu'une nouvelle version stable de Terraform est disponible, elle est ajoutée à la liste des versions compatibles. La nouvelle version de Terraform devient disponible dans la console Google Cloud , la gcloud CLI et l'API. Le tableau de gestion des versions est mis à jour avec la nouvelle version et sa date de disponibilité, et une note de version Infra Manager est créée.

Migration automatique

Lorsque vous mettez à jour un déploiement existant qui utilise une version non compatible, Infra Manager peut le mettre à jour automatiquement vers une version compatible. Cette fonctionnalité de migration automatique est un processus d'activation que vous configurez à l'aide d'une règle d'administration.

Si vous n'avez pas activé la migration automatique, toute opération de mise à jour que vous effectuez sur un déploiement qui utilise une version non compatible échouera. Pour continuer, vous devez modifier manuellement la configuration du déploiement afin de spécifier une version compatible, puis réessayer l'opération.

Configurer votre règle de migration automatique

Vous pouvez configurer la stratégie de migration automatique pour les versions Terraform sur Infra Manager à l'aide de Google Cloud CLI.

Pour activer votre règle de migration automatique :

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

Pour décrire votre règle de migration automatique :

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

Étapes suivantes