4. 标签与注解策略：Kubernetes Labels/Annotations 设计规范

在云原生成本分摊模型中，标签（Labels）与注解（Annotations）是连接资源消耗与业务维度的核心元数据载体。缺乏标准化标签策略，将导致成本数据无法准确归集、分摊模型失效。本节定义一套面向成本分摊的标签设计规范，确保从 Pod、Namespace 到云服务资源均能按统一维度进行成本核算。

4.1 Labels 与 Annotations 的职责边界

4.2 成本标签标准化规范

所有 Kubernetes 资源（Namespace、Deployment、StatefulSet、Pod、Service）必须携带以下标准成本标签。标签键采用 cost.kubernetes.io/ 命名空间前缀，避免与系统标签冲突。

4.2.1 必选成本标签

4.2.2 可选成本标签

4.3 成本分摊注解规范

Annotations 用于承载成本分摊引擎所需的计算参数，不参与资源选择，但直接影响分摊结果。

# 示例：为 Deployment 添加成本分摊注解
apiVersion: apps/v1
kind: Deployment
metadata:
  name: order-service
  annotations:
    cost.kubernetes.io/allocation-method: "weighted"        # 分摊方法：weighted / fixed / proportional
    cost.kubernetes.io/weight: "2.0"                        # 权重值，用于加权分摊
    cost.kubernetes.io/discount-rate: "0.85"                # 折扣率，用于内部计价
    cost.kubernetes.io/fixed-cost: "150.00"                 # 固定成本（月），单位：美元
    cost.kubernetes.io/chargeback-model: "direct"           # 计费模式：direct / shared / indirect

4.4 标签继承与覆盖策略

成本标签在资源层级间存在继承关系。合理的继承策略可减少重复标注，同时保留覆盖灵活性。

4.5 标签命名规范与校验规则

为确保标签在跨集群、跨工具链场景下的一致性，必须遵循以下命名与格式规范：

• 键格式：<prefix>/<name>，前缀使用反向域名（如 cost.kubernetes.io），名称使用小写字母、数字、连字符（-）和下划线（_）。
• 值格式：小写字母、数字、连字符、点号，长度 ≤ 63 字符，禁止空格和特殊字符。
• 禁止使用：可变标识符（如 Pod IP、随机后缀）、敏感信息（密码、）、临时环境标识。
• 校验工具：建议在 CI/CD 流水线中集成 kube-linter 或 conftest，对资源清单进行标签合规性检查。

4.6 标签策略实施建议

4.7 常见错误与避坑指南