Détecter une dérive sans appliquer de modification

ShellBeginner
Pratiquer maintenant

Introduction

Un rapport a été modifié en dehors de Terraform. Votre équipe a besoin d'une tâche d'observation qui identifie la différence, la distingue d'un échec d'exécution et laisse la décision de correction au processus de livraison avec revue.

Vous allez observer un environnement conforme, effectuer une modification externe contrôlée, répéter l'observation sans la corriger et tester une entrée de tâche invalide. Vous corrigerez ensuite le stockage au moyen d'un plan concret, d'une revue et d'une application distincts. L'action d'observation fournie exécute une planification native avec des codes de sortie détaillés et enregistre les résultats ; elle ne comporte aucune étape d'application automatique.

Vous devez comprendre les plans enregistrés, l'application après revue, l'état et l'isolation des environnements, ainsi que les codes de sortie du shell. Ce lab démarre indépendamment avec deux stockages de rapports existants et un objet voisin distinct. Ses entrées de release souhaitées et ses contrôles qualité sont déjà préparés et doivent rester inchangés.

Liens avec les certifications

Certification Tâche de l'examen Mise en pratique
DevOps Engineer – Professional (DOP-C02) Tâche 2.1 Pratique des bases de la gestion des modifications IaC : observer les différences et les erreurs réelles avant une correction examinée séparément.

Un plan natif en lecture seule classe l'observation en 0, 1 ou 2 ; la correction relève d'un processus distinct avec revue.

Observer un environnement conforme

Dans cette étape, vous allez créer une requête d'observation pour une révision source et un environnement explicites, puis interpréter un véritable résultat sans modification.

Entrez dans le dépôt préparé et chargez ses outils.

cd /home/labex/project/report-release
source environment.sh

Lisez la release souhaitée et les étapes de qualité.

cat release.auto.tfvars.json pipeline.json

delivery-release-preview et delivery-release-review contiennent tous deux actuellement release one report. Terraform gère chaque bucket et son rapport au moyen d'un état d'environnement distinct. delivery-release-neighbor/keep.txt constitue une donnée indépendante. Préservez les fichiers Terraform fournis, les entrées de release, le verrouillage, les tests et les étapes de qualité ; vos requêtes de tâches JSON modifiables sont distinctes de la configuration Terraform souhaitée.

Enregistrez le commit de référence actuel pour cette tâche et pour la correction ultérieure après revue.

git rev-parse HEAD > selected-revision.txt

Construisez la requête d'observation avec jq. -n démarre sans document d'entrée et --arg revision transmet une chaîne de manière sûre à l'expression JSON. La requête obtenue sélectionne explicitement preview et la révision source enregistrée.

jq -n --arg revision "$(cat selected-revision.txt)" '{revision: $revision, environment: "preview"}' > observation.json

Lisez la requête.

cat observation.json

Elle doit contenir l'identifiant complet du commit et environment: preview. Exécutez l'action d'observation fournie.

python3 delivery.py observe observation.json

Les résultats attendus sont le code de sortie natif Terraform 0 et classification: no_changes. La configuration souhaitée correspond actuellement à la cible observée. Ce résultat concerne le module et l'environnement sélectionnés, pas l'état de santé de tous les systèmes.

L'action exporte la source sélectionnée et exécute la commande native terraform plan -detailed-exitcode sans plan de sortie enregistré ni application. Elle enregistre le statut réel et les empreintes de l'état métier. L'absence de modification est une preuve utile ; elle n'autorise pas une modification ultérieure.

Lisez le rapport actuel directement depuis le stockage.

aws s3 cp s3://delivery-release-preview/report.txt -

Le résultat attendu est release one report.

Distinguer une dérive d'une erreur d'exécution

Dans cette étape, vous allez créer une modification externe connue et montrer qu'une observation répétée ne la corrige pas. Vous produirez aussi une véritable erreur native de validation d'entrée, qui ne doit être classée ni comme un environnement conforme ni comme une dérive détectée.

Préparez localement un petit rapport de remplacement. printf écrit le texte et son saut de ligne final.

printf 'outside edit\n' > outside-report.txt

Téléversez-le vers la clé de l'objet preview existant via l'AWS CLI. Cela modifie intentionnellement uniquement les octets du rapport en dehors de Terraform ; la source souhaitée et l'état métier de Terraform ne sont pas mis à jour.

aws s3 cp outside-report.txt s3://delivery-release-preview/report.txt --content-type text/plain

Observez à nouveau la source inchangée. Cette commande renvoie intentionnellement le code de sortie 2.

python3 delivery.py observe observation.json

Les résultats attendus sont classification: changes_detected et une mise à jour proposée pour restaurer le rapport. Le code natif 2 signifie qu'un plan réussi a trouvé des différences ; ce n'est pas un échec de fournisseur ou d'exécution. À la différence de la commande de génération de plan enregistré du lab précédent, cette commande d'observation transmet délibérément le statut natif pour que les appelants le classent.

Répétez exactement la même tâche. Cette commande renvoie intentionnellement le code de sortie 2 à nouveau.

python3 delivery.py observe observation.json

La différence doit subsister, car aucune des observations n'applique la proposition. Lisez l'objet réel après les deux exécutions.

aws s3 cp s3://delivery-release-preview/report.txt -

Il doit toujours contenir outside edit. La tâche signale la dérive sans réécrire silencieusement les données souhaitées ni écraser l'état métier. Les verrous natifs temporaires et les journaux d'accès ordinaires sont des effets de coordination, pas une correction.

Créez une requête invalide distincte. report_override est une entrée fournie réservée à l'observation pour tester une exécution invalide sans modifier la source enregistrée dans un commit. Un rapport vide enfreint la règle de validation existante du module. La requête valide d'origine reste inchangée.

jq '. + {report_override: ""}' observation.json > invalid-observation.json

Exécutez cette requête. Cette commande renvoie intentionnellement le code de sortie natif 1.

python3 delivery.py observe invalid-observation.json

Les résultats attendus sont classification: execution_error et The report input must not be empty. Il s'agit de l'échec de validation Terraform prévu. Un échec de réseau ou de fournisseur nécessiterait aussi une investigation ; il ne doit jamais être signalé comme une absence de modification ni traité comme une détection réussie de dérive.

Revenez à la requête valide d'origine. Cette commande renvoie intentionnellement le code de sortie 2, car la modification externe n'a pas été corrigée.

python3 delivery.py observe observation.json

Lisez à nouveau le rapport réel.

aws s3 cp s3://delivery-release-preview/report.txt -

Le résultat attendu est outside edit. Les exécutions valides répétées et l'exécution invalide n'ont pas corrigé l'objet, modifié la configuration de référence ni écrasé l'état métier. Les trois résultats natifs sont distincts : 0 pour aucune modification, 2 pour des modifications détectées et 1 pour une erreur d'exécution.

Corriger après revue et observer à nouveau

Dans cette étape, vous allez confier la différence connue au processus normal de livraison. L'observation a fourni des informations ; la séquence distincte plan/review/apply rend la correction explicite.

Générez un artefact concret de correction pour la même référence sélectionnée et l'environnement preview.

python3 delivery.py plan repair-baseline --revision "$(cat selected-revision.txt)" --environment preview

Les contrôles qualité doivent réussir et le plan natif 2 doit identifier la mise à jour du rapport. La commande de livraison renvoie 0, car elle a généré l'artefact avec succès. Les entrées source demandent toujours le rapport d'origine ; ne les modifiez pas pour masquer le changement externe.

Inspectez la proposition réelle et son contexte.

python3 delivery.py inspect repair-baseline

Confirmez qu'elle cible delivery-release-preview/report.txt et restaure le rapport de référence. La révision sélectionnée, le verrouillage et l'environnement doivent correspondre à la correction que vous souhaitez autoriser.

Enregistrez la revue.

python3 delivery.py review repair-baseline --revision "$(cat selected-revision.txt)" --environment preview

Appliquez ce plan binaire examiné via le point d'entrée fourni.

python3 delivery.py apply repair-baseline --revision "$(cat selected-revision.txt)" --environment preview

Le code de sortie natif 0 d'application est attendu. C'est la correction délibérée ; l'action d'observation elle-même n'a rien appliqué.

Exécutez une nouvelle fois l'observation d'origine.

python3 delivery.py observe observation.json

Les résultats attendus sont le code de sortie natif 0 et classification: no_changes. La source souhaitée et la cible réelle concordent maintenant. Cette observation finale doit laisser les octets de l'état métier corrigé inchangés.

Lisez le rapport restauré.

aws s3 cp s3://delivery-release-preview/report.txt -

Le résultat attendu est release one report. Vérifiez l'environnement voisin et les données indépendantes.

aws s3 cp s3://delivery-release-review/report.txt -

Le résultat attendu ici aussi est release one report.

aws s3 cp s3://delivery-release-neighbor/keep.txt -

Le résultat attendu est preserve release neighbor. Conservez les stockages existants restaurés, l'état et les preuves de la tâche pour l'évaluation. Aucune pile d'infrastructure distincte n'a été créée. Vous avez gardé l'observation reproductible et en lecture seule tout en faisant passer la correction réelle par un artefact explicite examiné.

Résumé

Vous avez configuré une tâche d'observation liée à une source précise et distingué les résultats natifs 0 sans modification, 2 avec modification détectée et 1 avec erreur d'exécution. Les observations répétées ont conservé la modification externe réelle et l'état métier. Un plan enregistré examiné séparément a effectué la correction, après quoi l'observation est revenue à l'absence de modification tout en préservant l'autre environnement et les données voisines.

L'observation et la correction ont des responsabilités différentes. Lisez les diagnostics et classez les erreurs avant de décider quoi modifier. Consultez la référence officielle des codes de sortie détaillés pour les statuts natifs utilisés ici.