Notion 与 Terraform / OpenTofu 基础设施变更审批(IaC Change Management)及云资源 CMDB 漂移治理实战
2026 年 11 月 18 日
一、为什么基础设施即代码(IaC)团队需要 Notion 变更审批与 CMDB 中枢? #
在多云与微服务架构下,运维与平台工程团队普遍使用 Terraform 或开源分支 OpenTofu 管理 AWS、阿里云、Cloudflare 与 Kubernetes 基础设施。然而,仅依赖代码仓库的 Pull Request 评审来管控生产环境变更,往往会遇到三大治理盲区:
- 非研发干系人无法感知变更影响面:Git PR 中的
terraform plan终端输出动辄上千行 HCL 差异,安全审计员、FinOps 成本负责人与业务线架构师很难快速识别哪些操作会销毁(destroy)有状态数据库或触发公网安全组放行。 - 配置漂移(Configuration Drift)缺乏跨团队闭环:夜间紧急故障时,值班工程师常在云控制台手工调整防火墙规则或扩容节点;次日定时
plan -detailed-exitcode虽能发现漂移,却没有结构化的 CMDB 台账来追踪“谁在何时修改、何时回写 HCL 代码”。 - 多环境晋级与合规审计取证困难:生产发布往往要求同时满足“技术 Owner 复核 + 安全/FinOps 审批 + 关联变更窗口”等多维门禁;将每次 Plan 摘要与关联资产沉淀到 Notion 后,即可与 企业级 CI/CD 持续交付流水线 及 多云 FinOps 成本治理中枢 形成完整审计证据链。
| 能力维度 | 原生 Git PR 评论 | Terraform Cloud / Atlantis | Notion IaC 变更与 CMDB 中枢 |
|---|---|---|---|
| 核心定位 | 代码级 Diff 评审与版本留痕 | IaC 执行器与远程 State 托管 | 跨角色变更审批(CAB)、云资产血缘与漂移审计中枢 |
| 变更风险可视化 | 纯文本折叠日志,难以聚合统计销毁数 | 展示增删改计数,但缺乏业务归属上下文 | 按环境、资源重要度与 destroy 数量自动计算爆炸半径 |
| 非技术团队参与度 | 极低(安全/财务通常无 Git 仓读写权) | 需额外购买执行平台席位 | 安全、FinOps 与项目经理可直接在审批看板会签 |
| 漂移巡检归因 | 仅流水线日志报错,易被忽略 | 支持定时健康检查通知 | 自动建单至漂移台账并关联责任服务,触发 SLA 倒计时 |
| 合规审计留存 | 分散在各个仓库 PR 中,跨库检索困难 | 仅保留 Workspace 级执行记录 | 与 版本发布与变更管理中枢 统一归档检索 |
二、云资源 CMDB 与 IaC 变更三表数据库架构设计 #
为避免把上万条云资源属性与高频 CI 执行日志混在同一张宽表中导致渲染卡顿,建议在 Notion 中搭建“变更审批单 + 云资产 CMDB + 漂移巡检日志”三表架构(关系与汇总配置规范参阅 关系和汇总官方指南 与 数据库架构速查表):
| 数据库名称 | 核心字段(属性名与类型) | 职责与权限管控 |
|---|---|---|
DB_IaC_Change_Requests(变更审批单) | 变更单号 (Title,如 IAC-2026-418)、目标环境 (Select: dev/staging/prod)、PR_URL (URL)、Commit_SHA (Text)、新增资源数 (Number)、变更资源数 (Number)、销毁资源数 (Number)、含高危有状态资源 (Checkbox)、Plan摘要 (Text)、关联云资产 (Relation -> DB_Cloud_Assets_CMDB)、审批状态 (Status: 待评审/CAB会签中/已批准待Apply/已执行/已驳回)、爆炸半径门禁 (Formula 2.0) | 仅授权 CI 机器人与审批管理员修改 审批状态,禁止申请人绕过流水线篡改 Commit_SHA |
DB_Cloud_Assets_CMDB(云资源资产台账) | 资源逻辑地址 (Title,如 aws_rds_cluster.prod_core)、云厂商与区域 (Select: AWS-us-east-1/Aliyun-cn-hangzhou/Cloudflare)、资源等级 (Select: Tier-0核心有状态/Tier-1关键网关/Tier-2无状态计算)、月度预估成本_USD (Number)、资产负责人 (Person)、关联漂移记录 (Relation -> DB_Drift_Audit_Logs) | 维护云资源的业务归属、容灾等级与是否允许破坏性重建(prevent_destroy) |
DB_Drift_Audit_Logs(配置漂移巡检日志) | 漂移事件ID (Title)、关联资产 (Relation -> DB_Cloud_Assets_CMDB)、发现时间 (Date)、漂移类型 (Select: 控制台手工修改/外部脚本变更/孤儿资源)、处置状态 (Status: 待认领/代码中对齐/已忽略白名单/已收敛)、响应SLA门禁 (Formula 2.0) | 由每日定时 Drift Detection 流水线自动写入,追踪控制台野蛮变更的收敛时效 |
三、五步打通 GitHub Actions terraform plan -json 自动入库与审批门禁 #
按照以下流水线步骤,将 Terraform / OpenTofu 的结构化变更计划安全写入 Notion,并把审批结果反哺给 apply 阶段(Notion API 密钥创建与授权参阅 创建 Notion API 集成指南):
- 创建最小权限 Notion Integration 与环境隔离库:在工作区后台建立专用机器人
IaC_Governance_Bot,仅向DB_IaC_Change_Requests、DB_Cloud_Assets_CMDB与DB_Drift_Audit_Logs三张表授予连接权限;切勿直接依赖视图筛选做权限隔离,详细边界参阅 Notion 共享与权限管理指南。 - 在 CI 中导出机器可读的二进制与 JSON Plan:在 GitHub Actions 的 Pull Request 工作流中执行
terraform plan -out=tfplan.binary(OpenTofu 命令为tofu plan -out=tfplan.binary),随后运行terraform show -json tfplan.binary > tfplan.json。 - 提取
resource_changes并过滤no-op空操作:直接把完整tfplan.json塞入 Notion 会远超单字段 2000 字符上限,且可能泄露敏感明文变量;必须在脚本层仅提取address、actions统计计数与脱敏后的前 15 条核心变更摘要。 - 部署含
429退避重试的 Node.js Plan 入库脚本(限流与队列机制参阅 Notion API 速率限制与容错实战):
import fs from 'node:fs';
import { Client } from '@notionhq/client';
const notion = new Client({ auth: process.env.NOTION_TOKEN });
async function withRetry(fn, retries = 3) {
for (let i = 0; i < retries; i++) {
try {
return await fn();
} catch (err) {
if (err.status === 429 && i < retries - 1) {
const waitSec = Number(err.headers?.['retry-after'] || 2);
await new Promise((r) => setTimeout(r, waitSec * 1000));
continue;
}
throw err;
}
}
}
export async function syncTerraformPlanToNotion(planJsonPath, meta) {
const plan = JSON.parse(fs.readFileSync(planJsonPath, 'utf8'));
const changes = (plan.resource_changes || []).filter(
(rc) => !rc.change.actions.includes('no-op') && !rc.change.actions.includes('read')
);
let createCnt = 0;
let updateCnt = 0;
let destroyCnt = 0;
let touchesStateful = false;
const summaryLines = [];
for (const item of changes) {
const acts = item.change.actions;
if (acts.includes('delete')) destroyCnt++;
else if (acts.includes('create')) createCnt++;
else updateCnt++;
if (/(rds|postgres|mysql|s3_bucket|kms|vpc|iam_role)/i.test(item.type)) {
touchesStateful = true;
}
if (summaryLines.length < 15) {
summaryLines.push(`[${acts.join('+')}] ${item.address}`);
}
}
const safeSummary = summaryLines.join('\n').slice(0, 1800) || '无资源结构变更';
return withRetry(() =>
notion.pages.create({
parent: { database_id: process.env.IAC_CHANGE_DB_ID },
properties: {
'变更单号': { title: [{ text: { content: meta.changeId } }] },
'目标环境': { select: { name: meta.env } },
'PR_URL': { url: meta.prUrl },
'Commit_SHA': { rich_text: [{ text: { content: meta.sha } }] },
'新增资源数': { number: createCnt },
'变更资源数': { number: updateCnt },
'销毁资源数': { number: destroyCnt },
'含高危有状态资源': { checkbox: touchesStateful },
'Plan摘要': { rich_text: [{ text: { content: safeSummary } }] },
'审批状态': { status: { name: destroyCnt > 0 || meta.env === 'prod' ? 'CAB会签中' : '待评审' } }
}
})
);
}
- 配置 Apply 前置校验卡点与漂移巡检:在正式执行
terraform apply前,由流水线轮询校验 Notion 对应Commit_SHA记录的审批状态是否严格等于已批准待Apply(防止 PR 追加新提交后沿用旧审批);同时每日凌晨定时运行plan -detailed-exitcode,一旦返回状态码2(存在配置漂移)即自动向DB_Drift_Audit_Logs写入待认领工单。
四、Formula 2.0 变更爆炸半径评分与漂移 SLA 门禁公式 #
在 DB_IaC_Change_Requests 中部署如下 Formula 2.0 公式(函数语法细节请参阅 Notion 公式核心指南 与 Formula 2.0 实战速查表),可穿透关联云资产台账的 资源等级 与未收敛漂移数,实时给出变更爆炸半径评分与发布拦截结论:
lets(
env, prop("目标环境"),
creates, prop("新增资源数"),
updates, prop("变更资源数"),
destroys, prop("销毁资源数"),
isStateful, prop("含高危有状态资源"),
touchesTier0, prop("关联云资产").some(current.prop("资源等级") == "Tier-0核心有状态"),
openDrifts, prop("关联云资产")
.map(current.prop("关联漂移记录").filter(current.prop("处置状态") != "已收敛" && current.prop("处置状态") != "已忽略白名单").length())
.sum(),
blastScore, (destroys * 25) + (updates * 5) + (creates * 2) + if(isStateful, 20, 0) + if(touchesTier0, 30, 0) + if(env == "prod", 15, 0),
ifs(
openDrifts > 0 && env == "prod",
style("🛑 存在 " + openDrifts + " 项未收敛漂移 · 禁止 prod Apply 覆盖", "red", "bold"),
(destroys > 0 && touchesTier0) || blastScore >= 80,
style("🚨 极高爆炸半径 (" + blastScore + "分) · 需双人 CAB 核准含销毁操作", "red", "bold"),
blastScore >= 40,
style("⚠️ 中高风险变更 (" + blastScore + "分) · 建议在低峰窗口执行", "orange", "bold"),
prop("审批状态") == "已执行",
style("🟢 变更已落地 (" + blastScore + "分)", "green"),
style("🔵 低风险标准变更 (" + blastScore + "分) · 可按常规评审放行", "blue")
)
)
五、生产环境高频异常排查与权限治理清单 #
在企业落地的早期阶段,团队往往容易在状态锁、敏感变量脱敏与视图权限上踩坑。下表汇总四类高频故障的根因与修复准则(更多 API 与数据库诊断请参阅 Notion 故障排查速查表):
| 异常现象 | 根因剖析 | 标准修复与拦截策略 |
|---|---|---|
Error acquiring the state lock 并发锁冲突 | 多条 PR 合并后同时触发 apply,或前一次 CI 超时强杀未释放后端 S3/DynamoDB 状态锁 | 在 GitHub Actions 配置按环境维度的 concurrency 串行组,严禁在未知执行状态时盲目 force-unlock |
| 旧审批被新代码提交“偷渡”绕过 | 工程师在 CAB 批准后又向同一 PR 推送了包含删除数据库的新 Commit,Notion 原审批单未失效 | Apply 阶段必须同时比对 Commit_SHA 与 审批状态 == 已批准待Apply,SHA 不一致立即阻断执行 |
Notion Plan摘要 写入 400 或泄露密钥 | 直接上传原始 Diff 文本超过 2000 字符上限,或包含未标记 sensitive = true 的环境变量明文 | 脚本层仅抽取 resource_changes 地址与动作枚举并截断在 1800 字符内,严禁同步 before/after 具体配置值 |
| 外包运维通过筛选视图看到核心生产 CMDB | 误将 Notion Linked Database 的 Filter 过滤当成行级权限隔离 | 主库 DB_Cloud_Assets_CMDB 仅授权平台组管理员,对外部协作者仅按单条变更页面执行 精细化页面共享 |
核心手册与速查工具矩阵
高频速查手册与生产力工具直达常见问题与答疑 (FAQ)
高频疑难解析与避坑指南A
完全不需要。绝大多数核心功能在免费 Free 计划中均可完整体验与实操练习,无需额外付费购买 Plus 或团队版。