3、服务目录概念：什么是服务目录、服务目录在平台工程中的作用、服务目录与CI/CD流水线的关联

3.1 服务目录的定义与核心要素

服务目录（Service Catalog）是平台工程中用于描述、注册和管理所有可复用服务及其元数据的结构化清单。它不仅是服务的“黄页”，更是平台团队与产品团队之间的契约接口，定义了服务的名称、版本、依赖、部署方式、SLA 以及接入入口。

一个标准的服务目录条目通常包含以下核心字段：

3.2 服务目录在平台工程中的作用

在平台工程体系中，服务目录承担着三大核心职能：

1. 可发现性（Discoverability）：产品团队无需重复造轮子，通过目录即可找到认证、日志、消息队列等基础服务，并一键获取接入配置。
2. 标准化治理（Standardization）：平台团队通过目录强制约束服务的命名规范、版本策略、部署模板和监控集成，消除“雪花服务器”和“手工作业”。
3. 自助式交付（Self-Service）：开发者通过目录发起服务创建、升级或退役请求，平台自动执行审批、流水线触发和环境配置，降低对平台团队的依赖。

下图展示了服务目录在平台工程中的位置及其与周边系统的交互关系：

3.3 服务目录与CI/CD流水线的关联

服务目录与 CI/CD 流水线之间是双向驱动的关系。目录为流水线提供标准化输入，流水线则负责将目录中的变更自动部署到目标环境，并回写最新的运行状态。

具体关联体现在以下四个层面：

以下是一个典型的 GitLab CI 流水线引用服务目录模板的代码片段：

# .gitlab-ci.yml
include:
  - project: 'platform/service-catalog'
    file:
      - 'templates/deploy.yml'
      - 'templates/test.yml'
    ref: v2.1.0

variables:
  SERVICE_NAME: payment-gateway
  SERVICE_VERSION: 2.1.0
  DEPLOY_ENV: staging

stages:
  - test
  - deploy

deploy-staging:
  stage: deploy
  extends: .deploy-template
  environment:
    name: staging
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'

下图展示了服务目录与 GitLab CI 流水线之间的数据流与状态同步机制：

3.4 服务目录的跨项目移植价值

当服务目录与 GitLab CI 流水线深度绑定后，跨项目移植不再是“复制粘贴 YAML”，而是通过目录的模板引用和变量覆盖机制，实现一次定义、多处复用。这种模式带来的直接收益包括：

• 一致性：所有项目使用同一套经过平台团队验证的部署模板，减少环境差异导致的故障。
• 可审计：目录中记录了每次流水线执行后的服务状态变更，形成完整的变更追溯链。
• 低门槛：新项目只需在目录中注册一个条目，即可自动获得完整的 CI/CD 流水线，无需从零编写。