4. 模板制品库概述

4.1 什么是模板制品库

模板制品库（Template Artifact Repository）是集群升级治理中用于存储、版本化和管理所有升级相关模板与配置文件的中央仓库。它不同于普通的容器镜像仓库或代码仓库，其核心管理对象是 升级模板——即描述集群升级步骤、参数、资源规格和校验规则的标准化 YAML/JSON 文件集合。

一个典型的模板制品库包含以下内容：

• 升级模板包：包含节点排空策略、API 废弃检查规则、组件版本映射等。
• 参数化配置文件：环境差异变量（如集群规模、网络 CIDR、存储类）。
• 校验与回滚脚本：升级前预检、升级后验证、失败回滚的自动化逻辑。
• 审计元数据：模板版本、签名、审批记录、变更说明。

4.2 制品库在集群升级中的角色

在集群升级生命周期中，模板制品库承担三个核心角色：存储、版本管理、审计。三者共同保障升级过程的可控性与可复现性。

4.3 模板制品库与升级流程的交互关系

下图展示了模板制品库在集群升级治理中的核心位置，以及它与 API 废弃检查、节点排空计划等模块的数据流关系。

4.4 制品库的版本管理策略

模板制品库采用 语义化版本（SemVer） 与 环境标签 相结合的管理策略，确保不同集群、不同升级路径使用正确的模板版本。

• 主版本号：模板结构或核心逻辑发生不兼容变更时递增（如排空策略从串行改为并行）。
• 次版本号：新增功能或参数，但保持向后兼容（如增加新的 API 废弃检查项）。
• 补丁版本号：修复缺陷或优化性能，不改变接口（如调整超时时间默认值）。
• 环境标签：如 stable、canary、production-ready，用于快速选择适用模板。

4.5 审计能力与合规要求

模板制品库的审计功能是集群升级治理中满足合规性（如 SOC2、ISO 27001）的关键环节。每次模板变更都会生成不可篡改的审计记录：

审计日志通常以 不可变日志 形式存储在制品库后端（如对象存储或区块链式数据库），并定期与 SIEM 系统同步，用于事后分析与合规审计。

4.6 模板制品库的典型目录结构

以下是一个生产级模板制品库的目录组织示例，展示了如何按升级路径、环境和组件分类管理模板：

template-repository/
├── upgrade-paths/
│   ├── v1.27-to-v1.28/
│   │   ├── preflight-check.yaml          # 预检模板
│   │   ├── drain-strategy.yaml           # 排空策略
│   │   ├── api-deprecation-rules.yaml    # API 废弃检查规则
│   │   └── rollback-plan.yaml            # 回滚计划
│   └── v1.28-to-v1.29/
│       ├── preflight-check.yaml
│       ├── drain-strategy.yaml
│       ├── api-deprecation-rules.yaml
│       └── rollback-plan.yaml
├── environments/
│   ├── dev/
│   │   └── values-override.yaml
│   ├── staging/
│   │   └── values-override.yaml
│   └── prod/
│       └── values-override.yaml
├── scripts/
│   ├── validate-drain.sh
│   ├── check-api-deprecation.sh
│   └── rollback-cluster.sh
└── metadata/
    ├── changelog.md
    └── audit-log/
        └── 2025-03-21.jsonl