4、资源模型核心属性：标识符、元数据、状态机、关系映射、版本控制

资源模型是 IDP 自助门户的“数据骨架”。在 IDP 中，每一个被管理的实体——从环境、集群、命名空间到数据库实例、CI/CD 流水线——都被抽象为资源。一个健壮的资源模型必须定义五个核心属性，才能支撑自动化编排、权限校验、生命周期管理和审计追溯。

4.1 核心属性总览

4.2 标识符（Identifier）

标识符是资源的“身份证”。在 IDP 中，推荐采用 分层命名空间 + 唯一名称 的组合策略：

• 全局唯一性： 使用 资源类型:命名空间:名称 三元组，例如 cluster:prod:eks-blue。
• 不可变性： 资源一旦创建，标识符不可修改。重命名应通过“创建新资源 + 废弃旧资源”实现。
• 可读性： 避免纯 UUID，采用有业务含义的短名称，便于日志排查和 CLI 操作。

# 标识符设计示例
# 格式：{type}:{namespace}:{name}
cluster:prod:eks-blue
namespace:prod-eks-blue:payment-svc
database:prod-payment:orders-db
pipeline:payment-svc:build-deploy

4.3 元数据（Metadata）

元数据是资源的“属性包”。IDP 的元数据设计应区分 系统元数据 和 自定义元数据：

4.4 状态机（State Machine）

状态机定义了资源从创建到销毁的合法路径。IDP 中的状态机必须是 确定性有限状态机（DFS），每个状态转换由明确的触发条件驱动。

4.5 关系映射（Relationship Mapping）

资源不是孤岛。关系映射定义了资源之间的 依赖、组合、引用 语义。IDP 中常见的关系类型包括：

• 容器关系（Parent-Child）： 集群包含命名空间，命名空间包含应用实例。删除父资源时应级联删除子资源。
• 依赖关系（Depends-On）： 应用依赖数据库连接串。数据库删除前应检查是否有依赖方。
• 绑定关系（Bound-To）： 服务账户绑定到 Secret，Secret 绑定到 Pod。绑定关系支持多对多。

4.6 版本控制（Version Control）

版本控制确保资源模型的每一次变更都可追溯、可回滚。IDP 中至少需要两个层面的版本管理：

# 资源 Spec 版本示例（YAML 片段）
apiVersion: idp.example.com/v1
kind: Database
metadata:
  name: orders-db
  resourceVersion: "42"          # 引擎维护的乐观锁版本
spec:
  engine: postgres
  version: "14.5"
  storage: 100Gi
status:
  observedGeneration: 42         # 当前 Spec 版本号
  phase: Running

4.7 五属性协同设计检查清单

在定义新的资源类型时，建议使用以下清单进行自检：

1. 标识符： 是否满足全局唯一、不可变、可读？是否包含资源类型前缀？
2. 元数据： 系统元数据是否完整？自定义元数据是否有 Schema 约束？
3. 状态机： 是否覆盖了完整生命周期？每个状态转换是否幂等？是否有“黑洞状态”？
4. 关系映射： 是否定义了父/子关系？依赖关系是否形成循环？级联删除策略是否明确？
5. 版本控制： Spec 版本是否支持乐观锁？Schema 版本是否向后兼容？