infrahub-common

Infrahub 共通リファレンス

このスキルには、他のすべての Infrahub スキルから参照される共有リソースが含まれています。直接呼び出すことは想定されていません。

内容

• graphql-queries.md — Infrahub GraphQL クエリの構文、 フィルター、ネストされたクエリ、ページネーションのパターン
• infrahub-yml-reference.md — .infrahub.yml 設定ファイルの形式とフィールドリファレンス
• marketplace-reference.md — Infrahub Marketplace: infrahubctl marketplace get による公開済みスキーマとコレクションの再利用、 infrahubctl marketplace list / search / show による検出、 およびエアギャップ時のフォールバック。ゼロからモデリングする前に再利用してください。
• netbox-vs-infrahub.md — NetBox の クエリ、テンプレート、オーバーレイデータを移植するエンジニア向けの フィールドごとの移行付録
• metadata-lineage.md — 値のメタデータ（source、 owner、is_protected）: 各フィールドの意味、 オブジェクトファイルでの設定方法、そして source が 編集アクセスを制御しない理由
• profiles-and-templates.md — Profiles と Object Templates の違いと仕組み
• rules/ — スキル間で共有される横断的なルール:
  • ブランチ優先のデータ CRUD（デフォルトブランチではなく、ブランチを既定とする）
  • クエリでの表示ラベルのキャッシュ
  • Python 環境と接続性のチェック
  • Git 統合とデプロイのパターン
  • マージ前に、変更された .gql クエリをライブの スキーマに対してドライランすること、および transform、check、generator に対して それを実行する infrahubctl コマンド
  • 部分的なリポジトリ同期からの復旧
  • 生成ファイルのプロトコル規約
  • infrahubctl graphql export-schema の出力としての schema.graphql — 再エクスポートされるものであり、決して 手動編集しない
  • 型付き SDK 呼び出しのための生成プロトコルの採用
  • 情報ソースの優先順位（スキルコンテンツを最優先とし、 真のギャップがある場合に docs.infrahub.app を参照するための 具体的な最終手段の手順を含む）