4. 回滚记录数据结构：版本号、时间戳、操作人、回滚前commit、回滚后commit、原因分类

在 GitOps 声明式发布模型中，回滚操作不是简单的“撤销”，而是一次有记录的、可审计的、可追溯的状态切换。每一次回滚都必须生成一条结构化的记录，作为运维审计、故障复盘、合规检查的核心依据。本节定义回滚记录的六个核心字段，并给出标准化的数据结构设计。

4.1 核心字段定义

回滚记录采用六元组结构，每个字段都有明确的语义和约束。下表列出字段名称、类型、说明及示例值：

4.2 原因分类枚举

原因分类是回滚记录中最重要的分析维度。我们将回滚原因归纳为以下五类，每类对应一个枚举值：

• deploy_failure — 部署失败：新版本发布后，Pod 无法启动、CrashLoopBackOff、健康检查失败。
• performance_regression — 性能回退：发布后 P99 延迟上升超过 20%、CPU/内存使用率异常升高。
• error_rate_spike — 错误率飙升：HTTP 5xx 错误率超过阈值、业务错误码激增。
• security_incident — 安全事件：发现漏洞、配置泄露、未授权访问。
• manual_intervention — 人工干预：运维人员主动回滚，原因需在备注中补充。

4.3 数据结构设计（JSON Schema）

回滚记录以 JSON 格式持久化存储，推荐使用以下 Schema 定义：

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "RollbackRecord",
  "type": "object",
  "required": [
    "version",
    "timestamp",
    "operator",
    "commit_before",
    "commit_after",
    "reason_category"
  ],
  "properties": {
    "version": {
      "type": "string",
      "pattern": "^rollback-v[0-9]+\\.[0-9]+\\.[0-9]+-[0-9]{8}$"
    },
    "timestamp": {
      "type": "string",
      "format": "date-time"
    },
    "operator": {
      "type": "string",
      "minLength": 1
    },
    "commit_before": {
      "type": "string",
      "pattern": "^[a-f0-9]{40}$"
    },
    "commit_after": {
      "type": "string",
      "pattern": "^[a-f0-9]{40}$"
    },
    "reason_category": {
      "type": "string",
      "enum": [
        "deploy_failure",
        "performance_regression",
        "error_rate_spike",
        "security_incident",
        "manual_intervention"
      ]
    },
    "notes": {
      "type": "string",
      "maxLength": 500
    }
  }
}

4.4 回滚记录生命周期流程

回滚记录不是静态的日志条目，它贯穿整个回滚操作的生命周期。下图展示了从触发到归档的完整流程：

4.5 记录存储与查询示例

回滚记录通常存储在 Elasticsearch、MongoDB 或关系型数据库中。以下是一个完整的记录示例：

{
  "version": "rollback-v2.1.0-20250321",
  "timestamp": "2025-03-21T14:30:00+08:00",
  "operator": "argocd-automation",
  "commit_before": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0",
  "commit_after": "f6e5d4c3b2a1b0c9d8e7f6a5b4c3d2e1f0a9b8c7",
  "reason_category": "error_rate_spike",
  "notes": "5xx error rate exceeded 5% threshold for 3 consecutive minutes"
}

查询回滚记录时，常用的过滤条件包括：

• 按时间范围查询：timestamp > "2025-03-20T00:00:00Z"
• 按原因分类聚合：reason_category = "deploy_failure"
• 按操作人追溯：operator = "zhang.san@company.com"
• 按 commit 关联：commit_before = "a1b2c3d4..."