1. 服务目录概述

服务目录（Service Catalog）是平台工程中连接平台能力与开发者需求的“统一入口”。它并非简单的服务列表，而是一个经过抽象、标准化、可被程序化调用的能力注册与发现机制。在CI/CD流水线上下文中，服务目录决定了流水线能够“编排哪些基础设施”、“调用哪些中间件”、“遵循哪些治理策略”。

1.1 服务目录在平台工程中的定义

服务目录将平台团队提供的所有可复用能力（计算、存储、网络、中间件、安全策略、部署模板等）封装为“服务项”，每个服务项包含明确的接口契约、配置参数、依赖关系和生命周期管理规则。开发者无需理解底层实现细节，只需通过声明式调用即可获得所需能力。

1.2 核心价值

服务目录为平台工程带来四个关键价值，这些价值直接决定了CI/CD流水线的效率与质量：

• 标准化：消除“每个团队一套部署脚本”的碎片化现象，所有服务项遵循统一接口规范，降低流水线适配成本。
• 可发现性：开发者或流水线引擎可以通过API动态查询可用服务、版本、配额和约束，无需翻阅静态文档。
• 治理内建：成本配额、安全基线、合规规则直接绑定在服务项定义中，流水线调用时自动执行策略校验，避免违规资源创建。
• 自助服务：开发者通过声明式配置（如YAML）即可在流水线中完成环境创建、中间件申请、配置注入等操作，减少等待平台团队介入的时间。

1.3 与CI/CD流水线的关联

服务目录与CI/CD流水线的关联体现在三个核心交互阶段：

1. 流水线初始化阶段：流水线启动时，通过服务目录API查询当前项目可用的构建环境、测试集群、部署目标等资源列表，动态生成流水线执行计划。
2. 任务执行阶段：每个流水线步骤（如编译、单元测试、集成测试、安全扫描、部署）通过服务目录获取具体的执行环境参数、中间件连接信息和配置模板。
3. 资源回收阶段：流水线结束后，通过服务目录触发临时资源的自动回收或状态更新，确保资源生命周期与流水线执行周期一致。

1.4 服务目录的典型数据模型

一个标准化的服务项通常包含以下核心字段，这些字段直接决定了CI/CD流水线如何解析和调用该服务：

1.5 服务目录的注册与发现流程

服务目录的生命周期管理包含两个关键流程：服务提供方（平台团队）的注册流程，以及服务消费方（CI/CD流水线）的发现流程。下图展示了这两个流程的协作关系：