3. Runbook 与 CI/CD 的集成模式

Runbook 与 CI/CD 流水线的集成并非单一模式，而是根据触发时机、事件来源和人工参与程度，分为四种主流模式。理解每种模式的适用场景与实现方式，是构建自动化运维体系的关键。

3.1 四种集成模式总览

3.2 触发式集成

触发式集成是最直接的模式：在 CI/CD 流水线的某个阶段（如部署后、测试前）显式调用 Runbook。Runbook 作为流水线的一个步骤被执行，其输出结果直接影响流水线的后续流程。

# Jenkinsfile 示例：触发式集成
pipeline {
    agent any
    stages {
        stage('Build') { steps { sh 'mvn clean package' } }
        stage('Deploy') { steps { sh 'kubectl apply -f deploy.yaml' } }
        stage('Post-Deploy Runbook') {
            steps {
                // 调用 Runbook 执行健康检查
                runbook 'health-check-runbook', parameters: [
                    string(name: 'ENV', value: 'production'),
                    string(name: 'TIMEOUT', value: '120')
                ]
            }
        }
        stage('Smoke Test') { steps { sh 'newman run smoke-tests.json' } }
    }
}

3.3 事件驱动集成

事件驱动集成将 Runbook 注册为事件的消费者。当监控系统、Git 仓库、云平台等产生特定事件时，通过 Webhook 或消息队列触发 Runbook 自动执行。这种模式实现了“感知-响应”的闭环自动化。

# 事件驱动集成示例：Prometheus Alertmanager 触发 Runbook
# alertmanager.yml 配置
receivers:
- name: 'auto-remediate'
  webhook_configs:
  - url: 'http://runbook-engine:8080/events'
    send_resolved: false
    # 仅当告警级别为 critical 时触发
    filters:
    - key: severity
      value: critical

事件驱动集成的典型链路：

• 监控告警 → Runbook → 自动修复：磁盘使用率超过 90% 时触发清理脚本。
• Git Push → Runbook → 环境同步：配置仓库变更后自动同步到所有测试环境。
• 云事件 → Runbook → 资源自愈：EC2 实例状态异常时自动重启并记录日志。

3.4 定时任务集成

定时任务集成通过 Cron 表达式定义 Runbook 的执行计划，适用于周期性、可预测的运维操作。这种模式不依赖流水线或外部事件，由独立的调度器负责触发。

# Rundeck 定时任务配置示例
- name: "Daily Build Cache Cleanup"
  schedule:
    cron: "0 3 * * *"
    timezone: "Asia/Shanghai"
  steps:
  - runbook: "cleanup-build-cache"
    args:
      retention_days: 7
      path: "/var/lib/jenkins/workspace/*/.m2"

3.5 手动审批集成

手动审批集成在流水线中插入“人工门禁”，只有经过授权人员审批后，Runbook 才会继续执行。这是高风险操作（如生产环境变更、数据删除）的最后一道防线。

典型流程：

1. 流水线运行到审批步骤，自动暂停并发送通知（邮件/IM/短信）。
2. 审批人查看变更详情、Runbook 执行计划、影响范围。
3. 审批人选择“批准”或“拒绝”，并填写审批意见。
4. 若批准，Runbook 继续执行；若拒绝，流水线中止并回滚。

# GitLab CI 手动审批集成示例
deploy-production:
  stage: deploy
  script:
    - runbook "pre-deploy-check" --env production
  environment:
    name: production
  when: manual          # 手动触发
  allow_failure: false  # 不允许失败，必须审批通过
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'
      when: manual
      allow_failure: false

3.6 集成模式对比与选型

3.7 混合集成模式

在实际生产环境中，四种模式并非互斥。一个复杂的 Runbook 可能同时包含多种集成特征：

• 定时 + 事件驱动：定时检查证书有效期，若发现即将过期则触发事件驱动 Runbook 自动续签。
• 触发式 + 手动审批：流水线部署到预发布环境后自动触发 Runbook 执行集成测试，但部署到生产环境前必须手动审批。
• 事件驱动 + 触发式：监控告警事件触发 Runbook 执行诊断，诊断完成后通过 Webhook 回调 CI/CD 流水线触发回滚流程。