6.2. ClusterInstance CR 用の並列 Argo CD パイプラインの準備

手順

1. 並列 Argo プロジェクトとアプリケーション用の YAML ファイルを作成します。

   1. AppProject リソースを定義する YAML ファイルを作成します。

      ztp-app-project-v2.yaml のサンプルファイル

      apiVersion: argoproj.io/v1alpha1
      kind: AppProject
      metadata:
        name: ztp-app-project-v2
        namespace: openshift-gitops
      spec:
        clusterResourceWhitelist:
        - group: hive.openshift.io
          kind: ClusterImageSet
        - group: hive.openshift.io
          kind: ClusterImageSet
        - group: cluster.open-cluster-management.io
          kind: ManagedCluster
        - group: ""
          kind: Namespace
        destinations:
        - namespace: '*'
          server: '*'
        namespaceResourceWhitelist:
        - group: ""
          kind: ConfigMap
        - group: ""
          kind: Namespace
        - group: ""
          kind: Secret
        - group: agent-install.openshift.io
          kind: InfraEnv
        - group: agent-install.openshift.io
          kind: NMStateConfig
        - group: extensions.hive.openshift.io
          kind: AgentClusterInstall
        - group: hive.openshift.io
          kind: ClusterDeployment
        - group: metal3.io
          kind: BareMetalHost
        - group: metal3.io
          kind: HostFirmwareSettings
        - group: agent.open-cluster-management.io
          kind: KlusterletAddonConfig
        - group: cluster.open-cluster-management.io
          kind: ManagedCluster
        - group: siteconfig.open-cluster-management.io
          kind: ClusterInstance 

      1

      
        sourceRepos:
        - '*'

      1

      ClusterInstance CR は、SiteConfig CR の代わりに siteconfig.open-cluster-management.io オブジェクトを管理します。

   2. Application リソースを定義する YAML ファイルを作成します。

      clusters-v2.yaml のサンプルファイル

      apiVersion: argoproj.io/v1alpha1
      kind: Application
      metadata:
        name: clusters-v2
        namespace: openshift-gitops
      spec:
        destination:
          namespace: clusters-sub
          server: https://kubernetes.default.svc
        ignoreDifferences:
        - group: cluster.open-cluster-management.io
          kind: ManagedCluster
          managedFieldsManagers:
          - controller
        project: ztp-app-project-v2 

      1

      
        source:
          path: site-configs-v2 

      2

      
          repoURL: http://infra.5g-deployment.lab:3000/student/ztp-repository.git
          targetRevision: main
        syncPolicy:
          syncOptions:
          - CreateNamespace=true
          - PrunePropagationPolicy=background
          - RespectIgnoreDifferences=true

      1

      project フィールドは、前のステップで作成した AppProject リソースの名前と一致する必要があります。

      2

      path フィールドは、ClusterInstance CR と関連リソースを格納した Git リポジトリー内のルートフォルダーと一致する必要があります。

      注記

      デフォルトで、auto-sync が有効になっています。ただし、同期は、クラスターの設定データを新しい設定フォルダー (この例では、site-configs-v2/ フォルダー) にプッシュした場合にのみ実行されます。

2. ClusterInstance CR と関連リソースが格納されたルートフォルダーを Git リポジトリーに作成してコミットします。以下はその例です。

   $ mkdir site-configs-v2
   $ touch site-configs-v2/.gitkeep
   $ git commit -s -m “Creates cluster-instance folder”
   $ git push origin main

   • .gitkeep ファイルは、空のフォルダーが Git によって追跡されるようにするためのプレースホルダーです。

     注記

     パイプラインのセットアップ中に、ルート site-configs-v2/ フォルダーの作成およびコミットのみ行う必要があります。クラスターの移行手順中に、完全な site-configs/ フォルダー構造を site-configs-v2/ にミラーリングします。

3. 次のコマンドを実行して、AppProject および Application リソースをハブクラスターに適用します。

   $ oc apply -f ztp-app-project-v2.yaml
   $ oc apply -f clusters-v2.yaml

検証

1. 次のコマンドを実行して、元の Argo CD プロジェクト (ztp-app-project) と新しい Argo CD プロジェクト (ztp-app-project-v2) がハブクラスターに存在することを確認します。

   $ oc get appprojects -n openshift-gitops

   出力例

   NAME                 AGE
   default              46h
   policy-app-project   42h
   ztp-app-project      18h
   ztp-app-project-v2    14s

2. 次のコマンドを実行して、元の Argo CD アプリケーション (clusters) と新しい Argo CD アプリケーション (clusters-v2) がハブクラスター上に存在することを確認します。

   $ oc get application.argo -n openshift-gitops

   出力例

   NAME                       SYNC STATUS   HEALTH STATUS
   clusters                   Synced        Healthy
   clusters-v2                Synced        Healthy
   policies                   Synced        Healthy