2. 服务目录平台基础：服务目录的定义、核心功能及其在多集群环境中的作用
服务目录（Service Catalog）是云原生微服务治理体系中的核心元数据中心。它并非简单的服务列表，而是一个具备注册、发现与元数据管理能力的动态基础设施组件。在多集群、多区域部署成为常态的今天，服务目录的成熟度直接决定了容量规划数据的可采集性、准确性和实时性。
2.1 服务目录的定义与核心价值
服务目录是一个集中化的、权威的服务元数据注册表，它记录了所有可访问服务的名称、版本、端点、依赖关系、健康状态以及运行时属性。其核心价值在于将“服务在哪里”和“服务是什么”这两个问题标准化，为上层流量调度、故障隔离和容量规划提供统一的真相来源（Source of Truth）。
容量规划视角： 没有服务目录，容量规划团队只能依赖分散的 CMDB、手动维护的 Excel 或各团队的 Prometheus 标签，导致数据口径不一致、服务归属混乱、依赖关系缺失。服务目录是自动化水位评估的第一道数据管道。
2.2 核心功能详解
服务目录平台通常包含三大核心功能模块：服务注册、服务发现与元数据管理。下表从功能定义、技术实现和容量规划价值三个维度进行对比。
| 核心功能 | 功能定义 | 典型技术实现 | 对容量规划的价值 |
|---|---|---|---|
| 服务注册 | 服务实例在启动时向目录上报自身信息（IP、端口、协议、版本），并在下线时主动注销。 | Kubernetes Service + EndpointSlice、Consul Agent、Eureka Client、Nacos SDK | 提供实例级水位数据采集的目标列表，是计算集群总容量与已用容量的基础。 |
| 服务发现 | 消费者或网关通过目录动态获取目标服务的可用实例列表，实现客户端负载均衡。 | CoreDNS、Consul DNS、Kubernetes API、Spring Cloud LoadBalancer | 通过发现流量分布，反推服务间调用链路的容量瓶颈，辅助评估依赖服务的冗余度。 |
| 元数据管理 | 存储服务的非运行时属性，如负责人、Git 仓库、SLA 等级、所属业务域、资源配额标签。 | Kubernetes Annotation/Label、Consul KV、Nacos 配置中心、自定义 CRD | 元数据是容量规划策略分片的关键维度（如按业务域聚合、按 SLA 等级设定水位阈值）。 |
2.3 多集群环境中的服务目录架构
在单集群环境中，服务目录通常与集群生命周期绑定。但在多集群（联邦集群、跨区域集群、混合云集群）场景下，服务目录必须解决全局统一视图与局部自治之间的矛盾。下图展示了一种典型的多集群服务目录架构。
2.4 服务目录在多集群水位评估中的关键作用
服务目录为多集群水位评估提供了三个不可替代的基础能力：
- 实例清单标准化： 通过统一的注册协议，将不同集群（K8s、VM、物理机）的服务实例抽象为统一的资源对象，使得容量规划引擎可以跨集群计算总容量。
- 元数据驱动的策略分片： 利用服务目录中的标签（如
tier=critical、region=beijing、version=v2），将水位评估策略按业务重要性、地域、版本进行分片，避免“一刀切”导致误判。 - 依赖关系图谱构建： 服务目录中记录的上下游依赖关系，是构建服务调用拓扑的基础。容量规划团队可以基于此图谱评估“当集群 A 的某服务扩容时，对集群 B 的依赖服务造成的容量冲击”。
实践案例： 某金融科技公司拥有 5 个生产集群（3 个国内、2 个海外）。在引入统一服务目录（基于 Consul + 自研全局聚合层）之前，容量规划团队需要手动登录 5 个集群的 Prometheus 查询实例数，耗时 2 小时且经常出错。接入服务目录后，全局目录每 30 秒自动聚合所有集群的实例水位，容量评估效率提升 90%，数据准确率达到 99.9%。
2.5 服务目录的元数据模型设计
为了支撑容量规划，服务目录的元数据模型至少应包含以下字段。这些字段将直接用于水位聚合与策略计算。
| 元数据字段 | 类型 | 示例值 | 容量规划用途 |
|---|---|---|---|
service_name |
string | order-service |
水位聚合的 Key |
cluster_id |
string | prod-bj-01 |
多集群分片维度 |
instance_count |
int | 10 |
已用容量基数 |
resource_quota |
map | {cpu: 4, mem: 8Gi} |
单实例容量规格 |
sla_tier |
string | P0 |
水位阈值等级 |
dependencies |
list | [payment-svc, inventory-svc] |
级联容量评估 |
通过上述元数据，容量规划平台可以自动生成类似“集群 prod-bj-01 中 P0 级别服务总实例数 120，已分配 CPU 480 核，当前水位 72%”的评估报告，而无需人工介入数据采集。