2. SLO 作业模板设计原则：模板化、参数化、可复用、跨环境适配

SLO 作业模板的核心设计思想围绕四个关键原则展开：模板化、参数化、可复用和跨环境适配。这四个原则共同构成了标准模板驱动方法的基础，确保 SLO 定义能够在不同服务、不同环境和不同团队之间高效流转，同时保持配置的一致性和可维护性。

2.1 四原则概述

下表总结了每个原则的核心目标、关键特征以及在 SLO 作业模板中的具体体现：

原则	核心目标	关键特征	SLO 模板中的体现
模板化	统一结构，消除重复	预定义骨架、固定字段、标准化格式	YAML/JSON 模板骨架，包含 service、slos、indicators 等固定顶层字段
参数化	分离变量与逻辑	占位符、变量注入、默认值机制	${env}、${service_name}、${target} 等占位符
可复用	一次定义，多处使用	模块化、组合、继承	基础模板被多个服务引用，通过 include 或 extends 机制复用
跨环境适配	环境感知，自动切换	环境变量映射、条件渲染、环境差异封装	根据 ${env} 值自动切换 SLI 指标源、告警阈值、时间窗口

2.2 模板化：从零散到标准

模板化的核心是将 SLO 定义从手写、零散的配置文件转变为具有固定结构的标准化骨架。一个标准的 SLO 作业模板通常包含以下固定字段：

• 元数据区：模板版本、作者、创建时间、描述。
• 服务定义区：服务名称、所属团队、负责人、PagerDuty 集成信息。
• SLO 定义区：SLO 名称、目标值（如 99.9%）、时间窗口（如 30 天）、合规类型。
• SLI 指标区：指标来源、查询语句、数据聚合方式、缺失数据处理策略。
• 告警规则区：燃烧速率告警、错误预算耗尽告警、多窗口告警。

2.3 参数化：变量驱动的灵活性

参数化是模板化的自然延伸。模板骨架固定后，通过变量占位符注入环境特定的值，实现“一份模板，多环境生效”。

典型的参数化占位符示例：

# SLO 模板片段 (slo_template.yaml)
apiVersion: slo.example.com/v1
kind: ServiceLevelObjective
metadata:
  name: ${service_name}-${slo_name}
  namespace: ${namespace}
  labels:
    environment: ${env}
    team: ${team_name}
spec:
  target: ${slo_target}
  window: ${window_duration}
  indicator:
    type: ${indicator_type}
    query: ${indicator_query}
    threshold: ${threshold_value}
  alerting:
    burnRate:
      fast:
        window: ${fast_burn_window}
        severity: ${fast_burn_severity}
      slow:
        window: ${slow_burn_window}
        severity: ${slow_burn_severity}

2.4 可复用：模块化组合与继承

可复用性通过模块化设计和模板继承机制实现。常见的复用模式包括：

• 基础模板复用：定义通用的 SLO 基础模板（如 HTTP 服务 SLO 模板），所有 HTTP 服务直接引用。
• 组合复用：将告警规则、SLI 指标定义拆分为独立模块，通过 include 机制组合到主模板中。
• 继承复用：子模板继承父模板的结构，并覆盖或扩展特定字段。

2.5 跨环境适配：环境感知的自动切换

跨环境适配是模板驱动方法在生产落地中的关键挑战。不同环境（开发、测试、预发布、生产）在以下维度存在差异：

环境维度	开发环境	测试环境	预发布环境	生产环境
SLO 目标值	无严格目标	宽松目标（如 95%）	接近生产（如 99%）	严格目标（如 99.9%）
时间窗口	1 天	7 天	14 天	30 天
指标源	模拟数据	测试集群	预发布集群	生产集群
告警接收人	开发团队	QA 团队	SRE 值班	SRE + 产品负责人
燃烧速率窗口	禁用	1h/6h	1h/6h	1h/6h/24h

跨环境适配通过参数化结合条件渲染实现。模板引擎根据 ${env} 变量的值，自动选择对应的配置块：

# 条件渲染示例 (使用 Go template 语法)
spec:
  target: {{ if eq .env "production" }}99.9{{ else if eq .env "staging" }}99{{ else }}95{{ end }}
  window: {{ if eq .env "production" }}30d{{ else }}7d{{ end }}
  indicator:
    source: {{ if eq .env "production" }}prod-prometheus{{ else }}dev-prometheus{{ end }}

2.6 四原则协同关系

下图展示了四个原则之间的协同关系：模板化提供骨架，参数化注入变量，可复用实现模块组合，跨环境适配确保环境感知。四者共同构成标准模板驱动方法的完整闭环。

2.7 实践案例：从原则到模板

以下是一个综合运用四原则的 SLO 作业模板示例，展示如何将理论转化为可执行的配置：

# 综合示例：HTTP API SLO 模板 (http_slo_template.yaml)
# 模板化：固定骨架结构
# 参数化：使用 ${} 占位符
# 可复用：作为基础模板被其他服务引用
# 跨环境适配：根据 ${env} 切换配置

template:
  name: http-api-slo-base
  version: v1.0
  description: "Standard SLO template for HTTP API services"

parameters:
  - name: env
    type: string
    allowed: [dev, test, staging, production]
    default: production
  - name: service_name
    type: string
    required: true
  - name: slo_target
    type: float
    default: 99.9

service:
  name: ${service_name}
  environment: ${env}
  team: ${team_name}

slos:
  - name: latency-p99
    displayName: "P99 Latency"
    target: ${slo_target}
    window: {{ if eq .env "production" }}30d{{ else }}7d{{ end }}
    indicator:
      type: latency
      source: {{ if eq .env "production" }}prod-prometheus{{ else }}dev-prometheus{{ end }}
      query: |
        histogram_quantile(0.99,
          sum(rate(http_request_duration_seconds_bucket{
            service="${service_name}"
          }[5m])) by (le)
        )
      threshold: 500  # 500ms
    alerting:
      burnRate:
        fast:
          window: 1h
          severity: {{ if eq .env "production" }}critical{{ else }}warning{{ end }}
        slow:
          window: 6h
          severity: {{ if eq .env "production" }}warning{{ else }}info{{ end }}