1. 课程导论：策略即代码、灰度发布与审计日志留痕

1.1 策略即代码（Policy as Code）概念

策略即代码（Policy as Code, PaC）是将基础设施、安全、合规与运维策略以机器可读的代码形式进行声明、版本化、测试与自动执行的一种工程实践。它打破了传统策略依赖人工审批、静态文档和事后审计的局限，使策略成为软件交付生命周期中的一等公民。

1.2 灰度发布与升级窗口的关系

灰度发布（Canary Release）是一种渐进式上线策略，通过将新版本流量逐步从 0% 提升到 100%，在真实生产环境中验证稳定性。升级窗口（Upgrade Window）则定义了允许执行变更操作的时间段与条件。两者结合形成“在可控窗口内，按灰度批次逐步推进”的升级模型。

• 升级窗口约束：业务低峰期、合规窗口、变更冻结期、审批有效期。
• 灰度批次策略：按实例数（如 1→3→10→全部）、按地域（如 1%→5%→20%→100%）、按用户标签（如内部→Beta→GA）。
• 窗口与批次的联动：每个灰度批次必须在窗口内完成健康检查与决策，超时或失败则自动回滚或暂停。

1.3 审计日志留痕的重要性

在升级窗口灰度批次场景中，审计日志留痕是合规运营与故障溯源的最后一道防线。每一次策略变更、批次推进、健康检查结果、人工干预或自动回滚，都必须产生不可篡改的审计记录。

审计日志留痕需要覆盖以下关键维度：

1. 策略变更记录：谁、在什么时间、修改了哪个策略文件（PR/MR 链接、变更 diff）。
2. 窗口判定记录：升级窗口条件是否满足、判定结果、判定依据（时间、告警状态、审批状态）。
3. 灰度批次执行记录：批次编号、目标实例/用户范围、开始时间、结束时间、健康检查指标。
4. 决策与干预记录：自动决策（继续/回滚/暂停）或人工干预（强制推进/终止），附带操作人身份与理由。
5. 结果与状态记录：最终发布状态、失败原因、回滚范围、遗留问题。

1.4 三者融合：策略即代码驱动灰度审计

将策略即代码、灰度发布与审计日志留痕三者融合，形成“策略代码化 → 窗口条件判定 → 灰度批次执行 → 审计日志自动生成”的闭环。每一行策略代码的变更、每一次窗口条件的满足、每一个灰度批次的推进，都自动产生结构化的审计记录，无需人工补录。