介绍
一份报告在 Terraform 之外被编辑。团队需要一个观察作业,识别差异,将其与执行失败区分开来,并将是否修复的决定交给经过审阅的交付工作流。
你将观察一个与配置一致的环境,执行受控的外部编辑,重复观察而不修复,并测试无效作业输入。随后,你将通过独立的具体计划、审阅和应用流程修复存储。提供的观察操作运行带详细退出码的原生计划命令并记录结果;没有自动 apply 步骤。
你应已了解已保存计划、经审阅的应用操作、状态与环境隔离,以及 shell 退出状态。本实验独立开始,提供两个现有报告存储和一个独立相邻对象。期望发布输入和质量关卡已准备好,必须保持不变。
与认证考试的关联
| 认证 | 考试任务 | 实践内容 |
|---|---|---|
| DevOps Engineer – Professional (DOP-C02) | 任务 2.1 | 基础 IaC 变更管理实践:在单独审阅的修复之前,观察实际差异和错误。 |

观察与配置一致的环境
在这一步中,你将为明确的源代码修订和环境创建观察请求,然后解读真实的无变更结果。
进入已准备好的仓库并加载工具。
cd /home/labex/project/report-release
source environment.sh
阅读期望发布内容和质量阶段。
cat release.auto.tfvars.json pipeline.json
delivery-release-preview 和 delivery-release-review 目前都包含 release one report。Terraform 通过独立的环境状态管理各自的存储桶和报告。delivery-release-neighbor/keep.txt 是无关数据。保留提供的 Terraform 文件、发布输入、锁文件、测试和质量阶段;你可以编辑的 JSON 作业请求独立于期望的 Terraform 配置。
为此作业和后续经过审阅的修复记录当前基线提交。
git rev-parse HEAD > selected-revision.txt
使用 jq 构建观察请求。-n 不读取输入文档,--arg revision 将字符串安全地提供给 JSON 表达式。生成的请求明确选择 preview 和记录的源代码修订。
jq -n --arg revision "$(cat selected-revision.txt)" '{revision: $revision, environment: "preview"}' > observation.json
读取请求。
cat observation.json
它应包含完整提交标识和 environment: preview。运行提供的观察操作。
python3 delivery.py observe observation.json
预期原生 Terraform 退出码为 0,并显示 classification: no_changes。期望配置目前与观察目标一致。此结果针对选定模块和环境,而非所有系统的健康状况。
此操作导出选定源代码,运行原生 terraform plan -detailed-exitcode,不保存输出计划,也不执行 apply。它记录实际状态码和业务状态指纹。无变更是有用证据,但不授权后续修改。
直接从存储读取当前报告。
aws s3 cp s3://delivery-release-preview/report.txt -
预期看到 release one report。
区分漂移与执行错误
在这一步中,你将进行一次已知的外部编辑,并证明重复观察不会修复它。你还将触发真正的原生输入验证错误,它不得被归类为环境无变更或检测到漂移。
在本地准备一份小型替换报告。printf 写入文本及末尾换行符。
printf 'outside edit\n' > outside-report.txt
通过 AWS CLI 将其上传到现有 preview 对象的键。此操作有意在 Terraform 之外仅更改报告字节,不更新期望源代码或 Terraform 业务状态。
aws s3 cp outside-report.txt s3://delivery-release-preview/report.txt --content-type text/plain
再次观察未改变的源代码。此命令预期返回退出码 2。
python3 delivery.py observe observation.json
预期看到 classification: changes_detected,以及恢复报告的拟议更新。原生退出码 2 表示成功的计划发现了差异,不是 provider 或执行失败。与前面实验的已保存计划生成命令不同,此观察命令刻意传递原生状态码,以便调用方分类。
重复同一个作业。此命令预期再次返回退出码 2。
python3 delivery.py observe observation.json
差异应仍存在,因为两次观察都未应用提案。两次运行后读取实际对象。
aws s3 cp s3://delivery-release-preview/report.txt -
内容必须仍为 outside edit。作业报告漂移,不会静默写回期望数据或覆盖业务状态。临时原生锁和普通访问日志是协调操作的影响,不是修复。
创建一个独立无效请求。report_override 是提供的仅用于观察的输入,用来测试无效运行而不更改已提交源代码。空报告违反模块现有验证规则。原始有效请求保持不变。
jq '. + {report_override: ""}' observation.json > invalid-observation.json
运行该请求。此命令预期返回原生退出码 1。
python3 delivery.py observe invalid-observation.json
预期看到 classification: execution_error 和 The report input must not be empty.。这是预期的 Terraform 验证失败。网络或 provider 失败同样需要调查;绝不能报告为无变更,也不能当作成功检测到漂移。
返回原始有效请求。由于外部编辑尚未修复,此命令预期返回退出码 2。
python3 delivery.py observe observation.json
再次读取实际报告。
aws s3 cp s3://delivery-release-preview/report.txt -
预期看到 outside edit。重复的有效运行和无效运行都没有修复对象、更改基线配置或覆盖业务状态。三类原生结果不同:0 表示无变更,2 表示检测到变更,1 表示执行错误。
通过审阅修复并再次观察
在这一步中,你将把已知差异交给常规交付工作流。观察提供信息;独立的 plan/review/apply 流程使修复成为明确操作。
为同一选定基线和 preview 环境生成具体修复产物。
python3 delivery.py plan repair-baseline --revision "$(cat selected-revision.txt)" --environment preview
预期质量关卡通过,原生 plan 退出码 2 标识报告更新。交付命令因成功生成产物而返回 0。源代码输入仍要求原始报告;不要编辑输入来隐藏外部变更。
检查实际提案和上下文。
python3 delivery.py inspect repair-baseline
确认其目标为 delivery-release-preview/report.txt,并恢复基线报告。选定修订、锁文件和环境必须与你打算授权的修复一致。
记录审阅。
python3 delivery.py review repair-baseline --revision "$(cat selected-revision.txt)" --environment preview
通过提供的入口应用已审阅的二进制计划。
python3 delivery.py apply repair-baseline --revision "$(cat selected-revision.txt)" --environment preview
预期原生 apply 退出码为 0。这是有意执行的修复;观察操作本身未应用任何变更。
再次运行原始观察请求。
python3 delivery.py observe observation.json
预期原生退出码为 0,并显示 classification: no_changes。期望源代码与实际目标现在一致。此最终观察必须保持修复后的业务状态字节不变。
读取恢复后的报告。
aws s3 cp s3://delivery-release-preview/report.txt -
预期看到 release one report。检查相邻环境和无关数据。
aws s3 cp s3://delivery-release-review/report.txt -
此处也预期看到 release one report。
aws s3 cp s3://delivery-release-neighbor/keep.txt -
预期看到 preserve release neighbor。保留恢复后的现有存储、状态和作业证据以供评估。没有创建独立基础设施资源栈。你使观察保持可重复且只读,并将实际修复交给明确审阅过的产物执行。
总结
你配置了针对特定源代码的观察作业,区分了原生无变更 0、检测到变更 2 和执行错误 1。重复观察保留了实际外部编辑和业务状态。独立的已审阅保存计划执行了修复,此后观察恢复为无变更,同时保留另一个环境和相邻数据。
观察与修复各有职责。决定更改什么之前,先读取诊断并对错误分类。有关本实验使用的原生状态码,请参阅官方详细退出码参考文档。



