4. Deployment 资源模型：Kubernetes Deployment YAML 结构解析与关键字段

Deployment 是 Kubernetes 中最常用的工作负载资源，它负责声明式地管理 Pod 副本、滚动更新、回滚以及自愈能力。在服务目录平台中，水位巡检的核心数据源正是 Deployment 的 YAML 定义及其运行时状态。理解 Deployment 的资源模型，是设计巡检指标、判定水位健康度的前提。

4.1 Deployment YAML 顶层结构

一个标准的 Deployment YAML 遵循 Kubernetes API 约定，包含以下四个顶层键：

水位巡检主要关注 spec 下的字段，以及 status 中反映实际运行状态的字段。

4.2 关键字段深度解析

以下字段直接决定 Deployment 的容量、稳定性与资源消耗，是巡检指标的计算来源。

4.2.1 replicas —— 副本数与期望水位

spec.replicas 定义了期望运行的 Pod 副本数量。它是水位巡检中最基础的指标：

• 期望副本数：YAML 中声明的值，代表业务期望的并发容量。
• 实际就绪副本数：status.readyReplicas，代表当前真正可用的 Pod 数量。
• 水位偏差：当 readyReplicas < replicas 时，表示集群资源不足或 Pod 启动失败，属于高优先级告警。

4.2.2 resources —— 资源配额与利用率

spec.template.spec.containers[].resources 定义了每个容器的 CPU 和内存请求（requests）与限制（limits）。这是水位巡检中判断资源是否超卖或浪费的核心依据。

4.2.3 livenessProbe / readinessProbe —— 健康探针与自愈水位

探针决定了 Kubernetes 何时认为 Pod 不健康并触发重启或摘流。水位巡检需要检查探针的配置完整性：

• livenessProbe：存活探针。如果失败，kubelet 会重启容器。缺失此探针可能导致“僵尸 Pod”长期占用资源。
• readinessProbe：就绪探针。如果失败，Pod 会从 Service 端点中移除。缺失此探针可能导致流量打到未就绪的 Pod，造成请求超时。
• startupProbe：启动探针（v1.16+）。用于慢启动容器，防止 livenessProbe 在启动期间误杀。

4.2.4 其他关键字段

4.3 Deployment 资源模型与水位巡检的映射关系

下图展示了 Deployment YAML 中的关键字段如何映射到服务目录平台的水位巡检维度：

4.4 完整 Deployment YAML 示例（带水位巡检注释）

apiVersion: apps/v1
kind: Deployment
metadata:
  name: order-service
  namespace: production
  labels:
    app: order
    service-catalog: "true"          # 服务目录平台标签
spec:
  replicas: 3                        # 【副本水位】期望 3 副本
  selector:
    matchLabels:
      app: order
  strategy:
    rollingUpdate:
      maxSurge: 1                    # 【配置水位】更新时最多超 1 个 Pod
      maxUnavailable: 0              # 【配置水位】更新时不允许中断
  template:
    metadata:
      labels:
        app: order
    spec:
      containers:
      - name: order-container
        image: registry.example.com/order:v2.1
        resources:
          requests:
            cpu: "500m"              # 【资源水位】请求 0.5 核
            memory: "512Mi"          # 【资源水位】请求 512MB
          limits:
            cpu: "1000m"             # 【资源水位】限制 1 核
            memory: "1Gi"            # 【资源水位】限制 1GB
        livenessProbe:               # 【健康水位】存活探针
          httpGet:
            path: /healthz
            port: 8080
          initialDelaySeconds: 15
          periodSeconds: 10
        readinessProbe:              # 【健康水位】就绪探针
          httpGet:
            path: /ready
            port: 8080
          initialDelaySeconds: 5
          periodSeconds: 5
        terminationGracePeriodSeconds: 30  # 【配置水位】优雅关闭 30s

4.5 水位巡检字段速查表

服务目录平台在巡检 Deployment 时，应至少采集以下字段并计算对应水位指标：