2. 标准模板驱动概念：模板驱动架构定义、模板化配置的优势、模板与策略分离原则

标准模板驱动是灰度发布准入控制从“硬编码校验”走向“声明式治理”的核心范式转换。其本质是将配置结构与执行逻辑解耦，通过预定义的模板契约，使不同业务线、不同集群的灰度准入规则能够以统一、可复用、可审计的方式表达。

2.1 模板驱动架构定义

模板驱动架构（Template-Driven Architecture, TDA）是一种以模板为中心的软件设计模式。在灰度发布准入场景中，它表现为：

• 模板定义：使用 YAML/JSON 等声明式语言，定义准入检查的“骨架”，包括检查项、参数占位符、条件分支。
• 模板实例化：运行时，由平台引擎读取模板，注入来自请求上下文、服务元数据、策略库的具体值，生成可执行的准入规则。
• 模板生命周期：模板本身具备版本、状态（草稿/生效/废弃）、环境标签，支持灰度发布场景下的渐进式生效。

2.2 模板化配置的优势

相比传统硬编码或手写策略文件，模板化配置在灰度发布准入场景中带来四个维度的显著提升：

2.3 模板与策略分离原则

这是模板驱动架构中最容易被忽视但至关重要的设计原则。分离的核心在于：模板定义“做什么”，策略定义“怎么做”。

• 模板（Template）：描述准入检查的结构和流程。例如：“检查新版本 Pod 的 readinessProbe 是否配置”、“验证灰度实例数是否在允许范围内”。模板是通用的，不绑定具体数值。
• 策略（Policy）：为模板中的占位符提供具体约束。例如：“readinessProbe 的 initialDelaySeconds 必须 ≥ 5”、“灰度实例数不得超过当前总实例的 30%”。策略是环境相关的，可随集群、命名空间、服务等级动态调整。

2.4 分离原则的工程落地

在 Kubernetes 原生生态中，模板与策略分离通常通过以下方式实现：

# 模板示例：灰度实例数检查模板 (grayscale-replica-check.yaml)
apiVersion: template.platform.io/v1
kind: AdmissionTemplate
metadata:
  name: replica-ratio-check
spec:
  # 模板定义检查结构，使用占位符
  checkItems:
    - name: "max-grayscale-ratio"
      description: "检查灰度实例占比是否超过阈值"
      expression: "grayscaleReplicas / totalReplicas <= ${maxRatio}"
      severity: "Critical"
    - name: "min-grayscale-replicas"
      description: "检查灰度实例数是否满足最小要求"
      expression: "grayscaleReplicas >= ${minReplicas}"
      severity: "Warning"
---
# 策略示例：生产环境策略 (prod-policy.yaml)
apiVersion: policy.platform.io/v1
kind: AdmissionPolicy
metadata:
  name: prod-grayscale-policy
  namespace: prod
spec:
  templateRef: "replica-ratio-check"   # 引用模板
  values:                               # 注入具体值
    maxRatio: 0.3                       # 生产环境灰度比例不超过 30%
    minReplicas: 2                      # 至少 2 个灰度实例
  target:
    clusters: ["prod-cluster-*"]
    services: ["critical-svc-*"]

2.5 本章小结