infrahub-common

Infrahub Common References

This skill contains shared resources referenced by all other Infrahub skills. It is not meant to be invoked directly.

Contents

• graphql-queries.md — Infrahub GraphQL query syntax, filters, nested queries, and pagination patterns
• infrahub-yml-reference.md — .infrahub.yml configuration file format and field reference
• marketplace-reference.md — Infrahub Marketplace: reusing published schemas and collections via infrahubctl marketplace get, discovery with infrahubctl marketplace list / search / show, and airgap fallback. Reuse before modelling from scratch.
• netbox-vs-infrahub.md — Field-by-field migration appendix for engineers porting NetBox queries, templates, or overlay data
• metadata-lineage.md — Value metadata (source, owner, is_protected): what each field means, how to set it in object files, and why source does not control edit access
• profiles-and-templates.md — The Profiles vs Object Templates distinction and mechanics
• rules/ — Cross-cutting rules shared across skills:
  • Branch-first data CRUD (default to a branch, not the default branch)
  • Caching display labels in queries
  • Python environment and connectivity checks
  • Git integration and deployment patterns
  • Dry-running a changed .gql query against the live schema before merge, and which infrahubctl command does it for a transform, check or generator
  • Recovery from partial repository syncs
  • Generated file protocol conventions
  • schema.graphql as infrahubctl graphql export-schema output — re-exported, never hand-edited
  • Adopting generated protocols for typed SDK calls
  • Information-source priority (skill content first, with a concrete last-resort procedure for consulting docs.infrahub.app on a genuine gap)