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 aux nouvelles fonctionnalités et corriger les failles de sécurité, Infra Manager met régulièrement à jour les versions de Terraform disponibles.

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

Fonctionnement de la règle

Infra Manager publie une liste des versions de 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 fournit des informations sur l'abandon des versions de Terraform :

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

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

  • Version Terraform : identifiant de la version Terraform.

  • Niveau de tarification : indique si la version est incluse dans le niveau sans frais (aucuns frais de gestion Infra Manager) ou payant (frais de déploiement et de gestion ; consultez Licences et tarifs des versions 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 compatibilité : date à laquelle la version n'est plus compatible. Cette période se termine 180 jours (ou plus) après l'abandon.

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

Pour afficher la liste actuelle des versions compatibles et leurs dates de cycle de vie, consultez Versions de 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 de compatibilité.

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 compatibilité.

Une fois la date de fin de compatibilité d'une version passée, celle-ci est marquée comme obsolète. Si vous tentez d'utiliser une version obsolète pour créer un déploiement, l'opération échoue et renvoie une erreur. 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. La table de gestion des versions est mise à jour avec la nouvelle version et sa date de disponibilité, et une note de version d'Infra Manager est créée.

Migration automatique

Lorsque vous mettez à jour un déploiement existant qui utilise une version non compatible, Infra Manager peut automatiquement mettre à jour le déploiement vers une version compatible. Cette fonctionnalité de migration automatique est un processus d'activation que vous configurez via 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 utilisant 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 règle de migration automatique pour les versions de Terraform sur Infra Manager à l'aide de la 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