Terraform Certification Hub
0 % complété
Se connecter

Fondamentaux de Terraform › Théorie › Leçon 3 sur 9

Installer et versionner les providers

Domaine 2 de l'examen, 10 % des questions. 20 questions couvrant les objectifs 2a, 2b, 2c et 2d.

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"