Terraform Certification Hub
0 % complété
Se connecter

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

Comment Terraform utilise l'état

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

Le domaine 6 traite l'état en profondeur. L'objectif 2d demande d'en comprendre le rôle.

5.1 Pourquoi un fichier d'état existe

Terraform doit relier une adresse de configuration à un objet réel. Rien dans l'API Google Cloud ne dit que l'instance 1234567890123456789 correspond au bloc google_compute_instance.app_prod de votre code.

Le state est cette table de correspondance. Il remplit quatre fonctions :

Fonction Ce que cela permet
Correspondance Relier une adresse de configuration à l'identifiant réel de la ressource
Métadonnées Conserver les dépendances pour ordonner correctement une destruction, même si le code a changé
Performance Servir de cache des attributs, évitant d'interroger l'API pour chaque ressource à chaque plan
Synchronisation Servir de point de coordination unique entre plusieurs opérateurs, via le verrouillage

5.2 Ce que le state contient

Un document JSON versionné, comportant le numéro de série, la version de Terraform, les outputs et la liste des ressources avec la totalité de leurs attributs.

Risque métier : cette totalité inclut les valeurs sensibles, en clair. Un mot de passe généré, une clé privée, une chaîne de connexion sont lisibles dans le state, y compris si l'attribut est marqué sensitive dans la configuration. Le marqueur sensitive masque la valeur dans la sortie du plan, il ne chiffre rien. Un state est donc à protéger comme un secret.

5.3 Ce que le state n'est pas

  • Ce n'est pas un inventaire de votre cloud. Il ne connaît que les ressources créées ou importées par cette configuration.
  • Ce n'est pas la source de vérité. La configuration l'est. Le state enregistre ce qui a été fait.
  • Ce n'est pas un fichier à éditer à la main. Les commandes terraform state existent pour cela.

5.4 Le cycle plan et apply

sequenceDiagram
    participant User as Opérateur
    participant Core as Terraform Core
    participant State as State
    participant Prov as Provider
    participant API as API du fournisseur

    User->>Core: terraform plan
    Core->>State: 1. Lit l'état enregistré
    Core->>Prov: 2. Demande le rafraîchissement
    Prov->>API: 3. Lit l'état réel de chaque ressource
    API-->>Prov: Attributs actuels
    Prov-->>Core: État réel
    Note over Core: 4. Compare configuration,<br>state et état réel
    Core-->>User: 5. Affiche le plan

    User->>Core: terraform apply
    Core->>Prov: 6. Exécute create, update, delete
    Prov->>API: 7. Appels d'API
    Core->>State: 8. Écrit le nouvel état

Retenir la comparaison à trois termes : la configuration (le désiré), le state (le connu) et l'infrastructure réelle (le constate). Le plan est le résultat de cette comparaison, pas d'une simple lecture du code.