3. CI/CD 服务目录基础

在标准模板与CI/CD治理体系中，服务目录是连接“模板定义”与“运行时消费”的核心枢纽。它并非简单的服务列表，而是一个包含元数据、版本、依赖关系及治理策略的结构化资产库。本章将深入剖析服务目录的概念、其与模板的协同关系，以及主流的消费模式。

3.1 服务目录的概念

服务目录（Service Catalog）是一个集中式的、经过治理的服务注册与发现中心。它记录了组织中所有可被消费的软件服务及其相关元数据，是DevOps标准化治理的“单一可信源”。

一个成熟的服务目录通常包含以下关键属性：

3.2 服务目录与模板的关系

服务目录与标准模板之间是实例化与抽象化的关系。模板定义了“如何构建”，而服务目录记录了“构建了什么”。两者通过模板引用这一元数据字段紧密耦合。

下图展示了服务目录与模板之间的核心交互逻辑：

从图中可以看出，服务目录中的每个实例都通过模板引用字段指向标准模板仓库中的具体版本。这种设计带来了以下优势：

• 一致性保障：所有基于同一模板创建的服务，其CI/CD流水线、代码结构、配置规范均保持一致。
• 版本追溯：当模板升级时，可以快速定位所有受影响的存量服务实例，并触发批量升级。
• 治理闭环：模板的变更会通过服务目录传播到所有实例，实现“模板即治理”的自动化闭环。

3.3 服务目录的消费模式

服务目录的价值在于被消费。根据消费方与使用场景的不同，主要存在以下三种消费模式：

下图展示了这三种消费模式在典型CI/CD流程中的交互位置：

3.3.1 开发者自助模式

开发者通过Web UI或CLI工具直接查询服务目录，完成以下操作：

• 服务创建：选择标准模板，填写服务元数据，自动生成代码仓库和CI/CD流水线。
• 依赖查询：查看某个服务的上游依赖和下游消费者，评估变更影响范围。
• 环境申请：基于目录中的环境定义，自助申请开发、测试或预发布环境。

3.3.2 CI/CD流水线模式

CI/CD系统在运行时通过API调用服务目录，实现动态决策：

• 构建阶段：流水线从目录获取依赖服务的版本信息，确保构建时使用正确的依赖版本。
• 部署阶段：校验目标服务的版本是否满足目录中的治理策略（如：生产环境必须使用经过安全扫描的版本）。
• 回滚决策：当部署失败时，从目录查询上一个稳定版本，自动触发回滚。

3.3.3 平台治理模式

平台工程团队利用服务目录进行全局治理：

• 合规审计：扫描目录中所有服务的模板引用版本，确保没有使用已废弃或不合规的模板。
• 批量升级：当模板发布新版本时，通过目录定位所有关联服务，批量创建升级工单或自动触发升级流水线。
• 服务拓扑：基于目录中的依赖关系，自动生成服务依赖拓扑图，用于容量规划和故障排查。