用途:这是 Infrahub 系列技能的共享参考资料,供其它技能内部引用,不应直接触发或作为独立技能调用。
主要内容:graphql-queries.md 收录 Infrahub GraphQL 的查询语法、过滤器、嵌套查询与分页模式;infrahub-yml-reference.md 说明 .infrahub.yml 配置格式与字段参考;marketplace-reference.md 介绍通过 infrahubctl marketplace get 复用已发布 schema 与 collection,用 infrahubctl marketplace list / search / show 发现,以及 airgap 回退方式;netbox-vs-infrahub.md 为从 NetBox 迁移查询、模板与 overlay 数据的逐字段附录;metadata-lineage.md 解释值元数据(source、owner、is_protected)的含义、在对象文件中设置的方法,以及 source 不控制编辑权限;profiles-and-templates.md 区分 Profiles 与 Object Templates。
rules/ 收录跨技能通用规则:分支优先的数据 CRUD(默认用分支而非默认分支)、在查询中缓存显示标签、Python 环境与连通性检查、Git 集成与部署模式、合并前对修改过的 .gql 查询针对实时 schema 做 dry-run(针对 transform、check 或 generator 的对应 infrahubctl 命令)、部分仓库同步的恢复、生成文件协议约定、schema.graphql 作为 infrahubctl graphql export-schema 输出需重新导出而非手改、采用生成协议进行类型化 SDK 调用,以及信息源优先级(技能内容优先,仅在确有缺口时按具体流程查阅 docs.infrahub.app)。
限制:资料未提供版本要求、依赖环境、许可证、收费信息,也未给出完整命令参数与示例,具体用法需结合实际 Infrahub 环境另行确认。