1. 课程导论与背景：什么是自助目录？为什么需要可靠性评审？Argo CD 在其中的核心角色
1.1 自助目录的定义与价值
自助目录（Self-Service Catalog）是一套标准化的服务发布与消费平台，允许开发团队通过声明式配置或 UI 界面，自主申请、部署和管理基础设施、中间件或应用组件，而无需等待平台运维团队手动介入。其核心价值在于：
- 降低认知负载：开发者无需理解底层基础设施细节，只需填写参数即可获得环境。
- 加速交付周期：从“提工单等待”变为“即时自服务”，环境准备时间从天级缩短到分钟级。
- 保证一致性：所有服务实例基于预定义的模板生成，避免“雪花服务器”和配置漂移。
- 强化治理：平台团队将安全策略、成本配额、合规规则嵌入目录模板，实现“左移”管控。
关键洞察：自助目录的本质是“平台工程”的产物——将平台能力产品化，让开发者聚焦业务逻辑，而非基础设施编排。
1.2 为什么需要可靠性评审？
自助目录虽然提升了效率，但也引入了新的可靠性风险。未经评审的目录模板可能导致以下问题：
| 风险类别 | 具体表现 | 影响范围 |
|---|---|---|
| 配置漂移 | 不同团队修改目录模板后，实例间配置不一致 | 故障定位困难，回滚失败 |
| 安全漏洞 | 模板中嵌入了过时镜像、弱密码或开放端口 | 生产环境被入侵 |
| 资源滥用 | 目录未设置资源配额，导致集群资源被单个应用耗尽 | 全局服务不可用 |
| 依赖断裂 | 目录服务依赖的底层 API 或中间件版本升级后未同步更新 | 实例创建失败或运行异常 |
| 可观测性缺失 | 目录模板未集成日志、指标、告警配置 | 故障时无法快速排障 |
可靠性评审（Reliability Review）正是在目录模板发布前，通过自动化检查与人工审批相结合的方式，对上述风险进行系统性验证。它确保每个目录项在进入生产环境前，都满足预定义的可靠性基线。
常见误区：很多团队认为“目录模板写好了就能直接用”。实际上，模板的可靠性需要像代码一样进行版本控制、静态分析、集成测试和变更评审。没有评审的目录，只是将混乱自动化了。
1.3 Argo CD 在其中的核心角色
Argo CD 作为 Kubernetes 生态中事实标准的 GitOps 工具，在自助目录可靠性评审体系中扮演了三个关键角色：
- 声明式同步引擎：Argo CD 持续监控 Git 仓库中的目录模板（Helm Chart / Kustomize / 纯 YAML），确保集群状态与模板定义完全一致。任何手动修改都会被自动回滚。
- 多环境差异对比：通过 Argo CD 的 UI 或 CLI，评审者可以直观对比“目录模板期望状态”与“当前集群实际状态”的差异，快速发现配置漂移。
- 策略即代码的载体：结合 Argo CD Image Updater、Argo CD ApplicationSet 以及 OPA/Gatekeeper 策略引擎，可以将可靠性检查（如镜像签名验证、资源配额校验、安全上下文检查）嵌入到同步流程中。
1.4 可靠性评审的自动化流程
基于 Argo CD 的可靠性评审并非一次性活动，而是一个持续集成的闭环。典型流程包含以下步骤：
- 模板提交：开发者将目录模板（含可靠性元数据）推送到 Git 仓库的特定分支。
- 预检阶段：CI 流水线触发静态检查（如
kubeconform验证 Schema、conftest执行 OPA 策略、trivy扫描镜像漏洞）。 - 预发布环境部署：Argo CD ApplicationSet 自动在预发布命名空间创建实例，触发集成测试。
- 差异评审：评审者通过 Argo CD UI 查看“期望状态 vs 实际状态”差异，确认无意外变更。
- 审批与合并：通过 PR 审批机制（如 GitHub / GitLab 的 required reviews），将模板合并到主分支。
- 生产同步：Argo CD 检测到主分支变更，自动同步到生产集群，并持续监控。
最佳实践：将可靠性评审的检查项（如“必须包含 Resource Limits”“必须启用 PodDisruptionBudget”）编码为 OPA 策略，并集成到 Argo CD 的 PreSync / PostSync 钩子中。这样，任何不符合策略的目录模板都无法完成同步。
1.5 课程目标与学习路径
本课程将围绕以下核心能力展开：
- 设计可靠性基线：定义适用于自助目录的可靠性检查清单（SLO、安全策略、成本配额）。
- 构建评审流水线：使用 Argo CD + GitHub Actions / GitLab CI 实现自动化预检与差异对比。
- 集成策略引擎：通过 OPA / Kyverno 将可靠性规则嵌入 Argo CD 同步流程。
- 实战案例演练：从零搭建一个包含数据库、消息队列、微服务的自助目录，并完成完整的可靠性评审。
预期成果：完成本课程后，你将能够独立设计并实施一套“提交即评审、评审即合规、合规即同步”的自助目录可靠性工程体系，将平台可靠性从“人工救火”转变为“代码定义、自动执行”。