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.