2、服务目录概念与价值

2.1 什么是服务目录

服务目录（Service Catalog）是平台工程中所有可被开发者发现、请求和使用的平台能力的结构化清单。它不仅仅是简单的服务列表，而是一个包含元数据、依赖关系、SLA、文档和自助操作入口的标准化知识库。

在平台工程语境下，服务目录将底层基础设施、中间件、运行时环境和业务能力抽象为“服务产品”，使开发者能够通过统一的界面或API进行浏览、选择和消费。

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

服务目录是平台工程三大支柱（开发者门户、平台API、服务目录）中的核心数据层。它承担以下关键角色：

2.3 服务目录对开发者效率的提升

服务目录通过以下机制直接提升开发者的交付效率：

• 发现效率提升 60%+：开发者无需在多个文档、Wiki和聊天记录中搜索服务信息，目录提供统一的搜索和过滤能力。
• 自助服务减少等待：开发者可直接从目录中申请数据库、消息队列、DNS记录等资源，无需提交工单等待运维响应。
• 上下文切换成本降低：目录中每个服务都包含完整的依赖关系图、API文档和运行状态，开发者无需切换工具链。
• 标准化减少返工：目录强制使用平台定义的服务模板和配置规范，避免因配置错误导致的重复工作。
• 知识传递加速：新成员通过浏览目录即可了解组织内所有服务及其关系，缩短 onboarding 时间。

2.4 服务目录的典型用例

以下是服务目录在平台工程实践中的六个典型用例：

1. 微服务注册与发现：开发者在目录中注册新微服务，自动生成API文档、监控面板和部署流水线配置。
2. 中间件资源自助申请：开发者通过目录选择所需的数据库类型（MySQL、Redis、Kafka等），指定规格后自动创建并返回连接信息。
3. 环境管理：目录中列出所有开发、测试、预发和生产环境，开发者可查看环境状态、部署版本和资源使用情况。
4. 依赖关系可视化：目录展示服务间的调用关系、数据流和依赖链，辅助架构评审和变更影响分析。
5. 合规与安全审计：目录记录每个服务的认证方式、加密策略和访问控制列表，支持一键导出审计报告。
6. 成本归属与优化：目录关联每个服务的云资源消耗，提供成本分摊视图，帮助团队识别浪费并优化。