Domaine 2, 10 % de l'examen. Objectifs 2a, 2b, 2c, 2d.
Architecture
| Composant |
Rôle |
| Terraform Core |
Lit le HCL, construit le graphe, calcule le plan, gère le state. Ne connaît aucune plateforme |
| Provider |
Plugin binaire distinct, traduit le graphe en appels d'API. Processus séparé, communication gRPC locale |
| Terraform Registry |
registry.terraform.io, source de téléchargement des providers et modules |
Niveaux de providers : officiel (HashiCorp, signed by HashiCorp), partenaire (éditeur, vérifié), communautaire (tiers, self-signed).
Adresse d'un provider : [hote]/[espace-de-noms]/[type], l'hôte valant registry.terraform.io par défaut.
Bloc terraform
terraform {
required_version = ">= 1.5.0" # contraint le Core
required_providers {
google = {
source = "hashicorp/google" # espace de noms obligatoire
version = "~> 6.0" # contraint le provider
}
}
}
Le bloc terraform n'accepte ni variable, ni expression, ni fonction. Valeurs littérales uniquement.
Contraintes de version
| Opérateur |
Exemple |
Accepte |
= ou rien |
= 6.12.0 |
6.12.0 exactement |
!= |
!= 6.12.0 |
tout sauf 6.12.0 |
>= > <= < |
>= 6.0 |
6.0 et au-delà |
~> sur le correctif |
~> 6.12.0 |
6.12.0 à 6.12.x, pas 6.13.0 |
~> sur la mineure |
~> 6.12 |
6.12 à 6.x, pas 7.0 |
| combinaison |
>= 6.0, < 7.0 |
les deux à la fois |
~> est l'opérateur pessimiste : incrément du dernier composant spécifié, tous les précédents figés.
terraform init
Quatre opérations, dans l'ordre : backend, modules, providers, fichier de verrouillage.
Ne crée aucune ressource. Idempotent, relançable sans risque.
À relancer après : ajout d'un provider, ajout d'un module, modification du bloc backend.
| Commande |
Effet |
terraform init |
Respecte les versions verrouillées si elles satisfont les contraintes |
terraform init -upgrade |
Ignore le verrouillage, resélectionne et réécrit le lock file |
terraform providers lock |
Ajoute les empreintes pour d'autres plateformes (CI sur un OS différent) |
terraform providers |
Affiche les providers requis par la configuration et par le state |
Fichier de verrouillage
.terraform.lock.hcl, à la racine du répertoire de travail. Contient par provider : l'adresse, la version sélectionnée, la contrainte, les empreintes.
| Fichier |
Commité ? |
.terraform.lock.hcl |
Oui |
*.tf |
Oui |
.terraform/ |
Non, reconstruit par init |
terraform.tfstate |
Non, secrets en clair |
Cache partagé des binaires : export TF_PLUGIN_CACHE_DIR="$HOME/.terraform.d/plugin-cache".
Configurations multiples de provider
provider "google" { # configuration par défaut
project = "mon-projet-prod"
region = "europe-west1"
}
provider "google" { # configuration additionnelle
alias = "us"
region = "us-central1"
}
resource "google_storage_bucket" "amerique" {
provider = google.us # référence, SANS guillemets
}
module "stockage_us" {
source = "./modules/bucket"
providers = { google = google.us }
}
Côté module enfant :
terraform {
required_providers {
google = {
source = "hashicorp/google"
configuration_aliases = [google.replique]
}
}
}
| Règle |
|
| Configuration par défaut |
Héritée automatiquement par les modules enfants |
| Configuration aliasée |
Non héritée, à passer par providers = {} |
Bloc provider dans un module réutilisable |
Anti-pattern. Les blocs provider appartiennent au module racine |
Credentials
Jamais dans le code. Variables d'environnement et identités de plateforme :
| Fournisseur |
Mécanisme |
| GCP |
GOOGLE_APPLICATION_CREDENTIALS, gcloud auth application-default login, identité de charge de travail |
| AWS |
AWS_ACCESS_KEY_ID, profils, rôles IAM d'instance |
| Azure |
az login, identité managée, principal de service |
| OCI |
fichier de configuration OCI, principal d'instance |
Le state
Quatre fonctions : correspondance (adresse vers identifiant réel), métadonnées (dépendances pour la destruction), performance (cache des attributs), synchronisation (verrouillage).
Format : JSON versionné. Champs notables : version (format), terraform_version, serial (incrémenté à chaque écriture), resources, outputs.
Ce que le state n'est pas :
- Pas un inventaire du cloud, il ne connaît que ce que cette configuration gère
- Pas la source de vérité, c'est la configuration
- Pas un fichier à éditer à la main
Comparaison du plan, trois termes : configuration (désiré), state (connu), infrastructure réelle (constaté).
Pièges d'examen
init ne crée aucune ressource.
source = "docker" cherche hashicorp/docker, qui n'existe pas. L'espace de noms est obligatoire.
~> 3.6 accepte 3.9. ~> 3.6.0 s'arrête à 3.6.x.
-upgrade ne met pas à jour le binaire Terraform, seulement les providers et modules.
init échoue si la version verrouillée ne satisfait plus la contrainte, au lieu de changer silencieusement.
provider = google.us sans guillemets, c'est une référence.
alias crée une seconde configuration, pas un second provider. terraform providers n'affiche qu'une entrée.
- Les configurations aliasées ne sont pas héritées par les modules enfants.
sensitive ne chiffre rien. La valeur est en clair dans le state.
- Le state n'est pas une sauvegarde. Le restaurer ne restaure aucune donnée.