4. 服务目录概述

服务目录是平台工程中连接平台能力与用户需求的核心元数据层。它并非简单的资产清单，而是一份以服务为中心、描述服务生命周期、依赖关系、所有权和运行态承诺的权威记录。在 SLO 作业模板与服务目录集成实践中，服务目录是模板的数据底座和路由引擎。

4.1 服务目录的定义

服务目录是一个结构化、可查询、可编程的元数据仓库，用于注册、发现和管理组织内所有平台服务（包括基础设施服务、中间件服务、业务服务）。每个服务条目通常包含以下核心属性：

4.2 服务目录在平台工程中的角色

在平台工程体系中，服务目录扮演着单一可信源的角色，是平台团队与业务团队之间的契约层。其核心角色可归纳为以下五个维度：

1. 服务发现与注册：提供统一的注册入口，使平台能力可被消费团队自助发现。
2. 所有权与责任映射：明确每个服务的 owner 团队，避免“孤儿服务”。
3. SLO 模板绑定引擎：根据服务分类、tier 自动匹配对应的 SLO 作业模板。
4. 依赖关系管理：记录服务间的调用链，支撑故障影响分析和容量规划。
5. 自动化运维触发：服务目录的变更（如版本升级、下线）可触发 CI/CD 流水线或告警策略更新。

4.3 服务目录与 CMDB 的区别

许多团队容易将服务目录与传统的 CMDB（配置管理数据库）混淆。虽然两者都管理配置数据，但在设计理念、数据模型、使用场景上存在本质差异。下表从多个维度进行对比：

4.4 服务目录与 CMDB 的协作关系

在成熟的平台工程实践中，服务目录与 CMDB 并非对立，而是形成分层协作的架构。服务目录提供业务视角，CMDB 提供基础设施视角，两者通过服务-配置项映射关联。

4.5 服务目录在 SLO 模板集成中的关键作用

在本课程的核心场景——SLO 作业模板与服务目录集成中，服务目录承担以下关键职责：

• 模板选择器：根据服务目录中的 tier、type 字段自动匹配对应的 SLO 作业模板。
• 参数注入源：从服务目录读取 owner、slack_channel、endpoints 等字段，注入到 SLO 作业模板的变量中。
• 依赖图提供者：为 SLO 作业提供服务的上下游依赖关系，用于计算复合 SLO 或错误预算传播。
• 变更事件触发器：当服务目录中的服务状态变更（如新增、退役）时，自动触发 SLO 作业模板的创建或清理。