• インベントリオブジェクトのデフォルトの場所
• インベントリオブジェクトの場所を変更
• inventory_policy オプション

GitLabが管理するクラスター・リソースの追跡（非推奨）

• GitLab 14.0 で導入されました。
• 15.3でGitLab PremiumからGitLab Freeに移動しました。

GitLabは、クラスターにデプロイしたリソースを追跡するためにインベントリオブジェクトを使用します。インベントリオブジェクトは、管理オブジェクトのリストを含むConfigMap 。管理されるリソースはcli-utils.sigs.k8s.io/inventory-id アノテーションを使います。

インベントリオブジェクトのデフォルトの場所

エージェント設定ファイルでは、プロジェクトのリストを指定します。例えば

gitops:
  manifest_projects:
  - id: gitlab-org/cluster-integration/gitlab-agent
    default_namespace: my-ns

エージェントは、manifest_projects リスト内のすべての項目に対してインベントリ・オブジェクトを作成します。インベントリ・オブジェクトは、default_namespace に指定したネームスペースに格納されます。

インベントリオブジェクトの名前と場所は、以下に基づいています：

• default_namespaceこのパラメータを指定しない場合、インベントリ・オブジェクトはdefault ネームスペースに格納されます。
• name は、マニフェストを持つプロジェクトの ID とエージェントの ID です。

インベントリオブジェクトの場所を変更

インベントリ・オブジェクトのネームスペースおよび名前を設定できます。このアクションは、クラスター内のオブジェクトの場所を変更します。

1. インベントリ・オブジェクト・テンプレート (ConfigMap オブジェクト) を作成します。例えば

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: unique-name-for-the-inventory
     namespace: my-project-namespace
     labels:
       cli-utils.sigs.k8s.io/inventory-id: unique-name-for-the-inventory
   

2. namespace とname. name将来、同じネームスペースにある他のインベントリ・オブジェクトと競合しないように、.NETnameが name一意であることをname確認して nameください。

3. cli-utils.sigs.k8s.io/inventory-id の値が一意であることを確認します。この値は、このインベントリ・オブジェクトによって追跡されるオブジェクトに使用されます。config.k8s.io/owning-inventory アノテーションはこの値に設定されます。

   値はname と一致する必要はありませんが、同じ値に設定すると便利です。

4. マニフェストファイルを含むファイルを 1 つの論理グループとして保存します。

inventory_policy オプション

マニフェストの変更が、GitLabインベントリオブジェクトによって追跡されないリソースに影響することがあります。

既存のリソースや以前追跡されていなかったリソースを上書きしたときのエージェントの動作を変更するには、inventory_policy の値を変更します。