4. ConfigMap 设计：将台账配置存储为 ConfigMap

在事故响应台账系统中，字段模板、通知规则、UI 文案等配置项与业务逻辑分离是保证可维护性的关键。Kubernetes ConfigMap 是专门用于存储非敏感配置数据的原生资源，将台账配置外挂到 ConfigMap 中，可以实现配置热更新、环境隔离和版本化管理。

4.1 台账配置的分类与 ConfigMap 映射

台账系统的配置项按变更频率和敏感度可分为三类，ConfigMap 适合承载前两类：

4.2 字段模板 ConfigMap 设计

字段模板定义了事故台账的元数据结构，包括字段名称、类型、是否必填、枚举值等。以下是一个典型的字段模板 ConfigMap 示例：

apiVersion: v1
kind: ConfigMap
metadata:
  name: incident-field-template
  namespace: incident-system
data:
  fields.json: |
    {
      "incident": {
        "title": { "type": "string", "required": true, "maxLength": 200 },
        "severity": {
          "type": "enum",
          "required": true,
          "values": ["P0", "P1", "P2", "P3"],
          "default": "P2"
        },
        "status": {
          "type": "enum",
          "required": true,
          "values": ["open", "investigating", "mitigating", "resolved", "closed"]
        },
        "assignee": { "type": "string", "required": false },
        "description": { "type": "text", "required": true, "maxLength": 5000 },
        "root_cause": { "type": "text", "required": false }
      }
    }
  severity_labels.properties: |
    P0=严重
    P1=高
    P2=中
    P3=低

字段模板配置通过 fields.json 键提供结构化定义，severity_labels.properties 键提供 UI 展示用的中文标签。应用启动时读取这些键，动态渲染表单和校验逻辑。

4.3 通知规则 ConfigMap 设计

通知规则配置了事故状态变更时的推送行为。采用多键值对方式存储，便于按规则独立更新：

apiVersion: v1
kind: ConfigMap
metadata:
  name: incident-notify-rules
  namespace: incident-system
data:
  rules.yaml: |
    rules:
      - name: "P0 立即通知"
        match:
          severity: "P0"
          status: "open"
        actions:
          - channel: "slack"
            target: "#incident-critical"
          - channel: "email"
            target: "oncall@company.com"
          - channel: "sms"
            target: "+8613800000000"
      - name: "状态变更通知"
        match:
          status: ["resolved", "closed"]
        actions:
          - channel: "slack"
            target: "#incident-updates"
  notify_interval: "30s"
  max_retries: "3"

4.4 ConfigMap 挂载与热加载策略

ConfigMap 可以通过 Volume 挂载或环境变量注入两种方式提供给 Pod。对于台账配置，推荐使用 Volume 挂载，支持文件级热更新：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: incident-api
  namespace: incident-system
spec:
  template:
    spec:
      containers:
        - name: api
          image: incident-api:1.2.0
          volumeMounts:
            - name: field-template
              mountPath: /app/config/fields
              readOnly: true
            - name: notify-rules
              mountPath: /app/config/notify
              readOnly: true
      volumes:
        - name: field-template
          configMap:
            name: incident-field-template
        - name: notify-rules
          configMap:
            name: incident-notify-rules

当 ConfigMap 更新后，挂载到 Pod 中的文件会在几分钟内自动同步（由 kubelet 的 sync period 控制）。应用层可以监听文件变化或定期重读配置，实现无需重启 Pod 的配置热加载。

4.5 ConfigMap 配置的版本管理与环境隔离

不同环境（dev / staging / prod）的字段模板和通知规则通常存在差异。推荐使用 命名约定 + Kustomize 实现环境隔离：

通过 Kustomize 的 nameSuffix 或 patches 机制，可以在不同 overlay 中覆盖 ConfigMap 的 data 字段，避免重复编写完整配置。

4.6 ConfigMap 配置校验与 CI 集成

为防止配置错误导致台账系统异常，建议在 CI 流水线中加入 ConfigMap 校验步骤：

1. Schema 校验：使用 kubectl --validate 或 kubeconform 检查 ConfigMap YAML 语法。
2. 内容校验：编写脚本解析 fields.json 和 rules.yaml，验证字段类型、枚举值、通知渠道是否合法。
3. 集成测试：在测试集群中 apply ConfigMap 并启动 Pod，验证配置能被正确加载和解析。

# CI 校验示例（GitLab CI 片段）
validate-config:
  stage: validate
  script:
    - kubectl --validate -f configmaps/incident-field-template.yaml
    - python scripts/validate_field_template.py configmaps/incident-field-template.yaml
    - python scripts/validate_notify_rules.py configmaps/incident-notify-rules.yaml

4.7 ConfigMap 配置架构总览

下图展示了台账配置从定义、存储到消费的完整链路：

4.8 最佳实践清单

• 命名规范：ConfigMap 名称包含环境后缀（如 -prod），避免跨环境误用。
• 数据大小：单个 ConfigMap 的 data 总大小不超过 1 MiB，超出时拆分为多个 ConfigMap 或使用其他存储方案。
• 只读挂载：始终设置 readOnly: true，防止应用意外修改配置。
• 版本追踪：在 ConfigMap 的 annotations 中记录版本号或变更时间，便于回滚和审计。
• 依赖声明：在 Deployment 的 spec.template.metadata.annotations 中添加 ConfigMap 的 hash，确保配置变更触发 Pod 滚动更新。

# 在 Deployment 中注入 ConfigMap hash 实现配置变更自动滚动更新
kind: Deployment
spec:
  template:
    metadata:
      annotations:
        checksum/config: ${CONFIG_HASH}  # CI 中计算并替换