用途:为 Infrahub 创建对象(数据)文件。对象是 YAML 文件,用于向模式节点填充实际基础设施数据,例如设备、位置、组织、模块等。
适用时机:创建新的基础设施对象数据文件;填充设备、位置、组织或其他模式节点;搭建层级数据(位置树、租户组);跨文件引用相关对象;管理组件子项(接口、模块);组织对象文件以获得正确的加载顺序。
对象文件基本结构:apiVersion、kind、spec.kind 与 spec.data 始终是必需项,每个 spec 块针对单一节点种类。示例:
apiVersion: infrahub.app/v1 kind: Object spec: kind: <NodeKind> data: - <attribute>: <value>
规则类别(按优先级):
- CRITICAL 文件格式(format-):apiVersion、kind、spec 结构
- CRITICAL 值映射(value-):属性、下拉项、引用
- HIGH 子项(children-):层级/组件嵌套
- MEDIUM 范围(range-):顺序接口展开
- MEDIUM 组织(organization-):命名、加载顺序、多文档
- LOW 模式(patterns-):平面列表、设备、git 仓库
配套参考:reference.md 提供对象文件格式规范;examples.md 收录 15 个来自生产仓库的完整对象模式;../infrahub-common/infrahub-yml-reference.md 说明 .infrahub.yml 项目配置;../infrahub-common/rules/ 提供跨技能的共享规则(git 集成、缓存);../infrahub-schema-creator/SKILL.md 提供这些对象所遵循的模式定义;rules/ 目录按类别前缀存放各条规则。
限制:本资料未提供具体收费、价格、支持平台及完整使用步骤等信息。