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 集成指南):

  1. 创建最小权限 Notion Integration 与环境隔离库:在工作区后台建立专用机器人 IaC_Governance_Bot,仅向 DB_IaC_Change_Requests、DB_Cloud_Assets_CMDB 与 DB_Drift_Audit_Logs 三张表授予连接权限;切勿直接依赖视图筛选做权限隔离,详细边界参阅 Notion 共享与权限管理指南。
  2. 在 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。
  3. 提取 resource_changes 并过滤 no-op 空操作:直接把完整 tfplan.json 塞入 Notion 会远超单字段 2000 字符上限,且可能泄露敏感明文变量;必须在脚本层仅提取 address、actions 统计计数与脱敏后的前 15 条核心变更摘要。
  4. 部署含 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会签中' : '待评审' } }
      }
    })
  );
}
  1. 配置 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 或团队版。