3.1 Le bloc required_providers
La déclaration se fait dans le bloc terraform, qui est le seul bloc de configuration de Terraform lui-même.
terraform {
required_version = ">= 1.5.0"
required_providers {
google = {
source = "hashicorp/google"
version = "~> 6.0"
}
random = {
source = "hashicorp/random"
version = "~> 3.6"
}
}
}
Deux contraintes distinctes coexistent et sont souvent confondues à l'examen :
| Argument |
Porte sur |
Emplacement |
required_version |
La version du Terraform Core |
Bloc terraform, directement |
version dans required_providers |
La version d'un provider |
Bloc required_providers |
Le bloc terraform n'accepte ni variable, ni expression, ni fonction. Ses valeurs doivent être littérales : c'est lu avant que le reste de la configuration ne soit évalué.
3.2 Les contraintes de version
| Opérateur |
Exemple |
Versions acceptées |
= ou rien |
= 6.12.0 |
Exactement 6.12.0 |
!= |
!= 6.12.0 |
Toutes sauf 6.12.0 |
>= |
>= 6.0 |
6.0 et au-delà, sans limite |
<=, <, > |
< 7.0 |
Strictement inférieur à 7.0 |
~> |
~> 6.12.0 |
6.12.0 à 6.12.x, pas 6.13.0 |
~> |
~> 6.12 |
6.12 à 6.x, pas 7.0 |
| combinaison |
>= 6.0, < 7.0 |
Les deux conditions simultanément |
L'opérateur ~> s'appelle l'opérateur pessimiste. Il autorise l'incrément du dernier composant spécifié et fige tous ceux qui précèdent. La nuance entre ~> 6.12.0 et ~> 6.12 tombe régulièrement à l'examen.
Risque métier : une contrainte ouverte comme >= 6.0 autorise Terraform a installer n'importe quelle version future au prochain init sur un poste neuf ou un agent CI. Un changement de comportement du provider arrive alors en production sans avoir été testé. En production, la pratique est ~> sur une version mineure, ou une version exacte accompagnée d'un processus de mise à jour.
3.3 Le fichier de verrouillage des dépendances
.terraform.lock.hcl est écrit par init à la racine du répertoire de travail. Il enregistre, pour chaque provider, la version sélectionnée, la contrainte qui l'a produite, et les empreintes cryptographiques des binaires.
provider "registry.terraform.io/hashicorp/random" {
version = "3.7.2"
constraints = "~> 3.6"
hashes = [
"h1:cFGCdxTlsrteTiaOV/iOQdql7eJkD3F/vtJxenkj9IE=",
...
]
}
Ce fichier se commite dans le dépôt Git. C'est ce qui garantit que tous les postes et toutes les exécutions CI utilisent exactement les mêmes binaires de provider. Le répertoire .terraform/, lui, ne se commite pas : il contient les binaires téléchargés, qui se reconstruisent.
| Commande |
Effet sur le lock file |
terraform init |
Respecte les versions verrouillées si elles satisfont les contraintes |
terraform init -upgrade |
Ignore les versions verrouillées, resélectionne la plus récente compatible et réécrit le fichier |
terraform providers lock |
Ajoute les empreintes pour d'autres plateformes, utile quand la CI tourne sur un OS différent du poste |
Piège d'examen : -upgrade porte sur les providers et les modules, pas sur le Terraform Core. Mettre à jour Terraform lui-même se fait par le gestionnaire de paquets.
3.4 Où vont les binaires
Les binaires sont téléchargés dans .terraform/providers/ du répertoire de travail. Sur un poste qui gère plusieurs projets, cela duplique les mêmes fichiers. Le cache de plugins évite cette duplication :
export TF_PLUGIN_CACHE_DIR="$HOME/.terraform.d/plugin-cache"