エッジコンピューティング

手順

1. ミラーホストにログインします。

2. mirror.openshift.com から RHCOS ISO イメージおよび RootFS イメージを取得します。以下は例になります。

   1. 必要なイメージ名と OpenShift Container Platform のバージョンを環境変数としてエクスポートします。

      $ export ISO_IMAGE_NAME=<iso_image_name> 

      1

      Copy to Clipboard Toggle word wrap

      $ export ROOTFS_IMAGE_NAME=<rootfs_image_name> 

      1

      Copy to Clipboard Toggle word wrap

      $ export OCP_VERSION=<ocp_version> 

      1

      Copy to Clipboard Toggle word wrap

      1

      ISO イメージ名 (例: rhcos-4.20.1-x86_64-live.x86_64.iso)

      1

      RootFS イメージ名 (例: rhcos-4.20.1-x86_64-live-rootfs.x86_64.img)

      1

      OpenShift Container Platform バージョン (例: 4.20.1)

   2. 必要なイメージをダウンロードします。

      $ sudo wget https://mirror.openshift.com/pub/openshift-v4/dependencies/rhcos/4.20/${OCP_VERSION}/${ISO_IMAGE_NAME} -O /var/www/html/${ISO_IMAGE_NAME}

      Copy to Clipboard Toggle word wrap

      $ sudo wget https://mirror.openshift.com/pub/openshift-v4/dependencies/rhcos/4.20/${OCP_VERSION}/${ROOTFS_IMAGE_NAME} -O /var/www/html/${ROOTFS_IMAGE_NAME}

      Copy to Clipboard Toggle word wrap

手順

1. Provisioning リソースを有効にして、すべての namespace を監視し、非接続環境のミラーを設定します。詳細は、Central Infrastructure Management サービスの有効化 を参照してください。

2. spec.osImages フィールドを更新するために、次のコマンドを実行して AgentServiceConfig CR を開きます。

   $ oc edit AgentServiceConfig

   Copy to Clipboard Toggle word wrap

3. AgentServiceConfig CR の spec.osImages フィールドを更新します。

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
    name: agent
   spec:
   # ...
     osImages:
       - cpuArchitecture: x86_64
         openshiftVersion: "4.20"
         rootFSUrl: https://<host>/<path>/rhcos-live-rootfs.x86_64.img
         url: https://<host>/<path>/rhcos-live.x86_64.iso

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   <host>

   ターゲットミラーレジストリー HTTP サーバーの完全修飾ドメイン名 (FQDN) を指定します。

   <path>

   ターゲットミラーレジストリー上のイメージへのパスを指定します。

4. エディターを保存して終了し、変更を適用します。

手順

1. ミラーレジストリー設定を含む ConfigMap を作成します。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: assisted-installer-mirror-config
     namespace: multicluster-engine 

   1

   
     labels:
       app: assisted-service
   data:
     ca-bundle.crt: | 

   2

   
       -----BEGIN CERTIFICATE-----
       <certificate_contents>
       -----END CERTIFICATE-----
   
     registries.conf: | 

   3

   
       unqualified-search-registries = ["registry.access.redhat.com", "docker.io"]
   
       [[registry]]
          prefix = ""
          location = "quay.io/example-repository" 

   4

   
          mirror-by-digest-only = true
   
          [[registry.mirror]]
          location = "mirror1.registry.corp.com:5000/example-repository" 

   5

   Copy to Clipboard Toggle word wrap

   1

   ConfigMap namespace は multicluster-engine に設定する必要があります。

   2

   ミラーレジストリーの作成時に使用されるミラーレジストリーの証明書。

   3

   ミラーレジストリーの設定ファイル。ミラーレジストリー設定は、検出イメージの /etc/containers/registries.conf ファイルにミラー情報を追加します。ミラー情報は、インストールプログラムに渡される際、install-config.yaml ファイルの imageContentSources セクションに保存されます。ハブクラスターで実行される Assisted Service Pod は、設定されたミラーレジストリーからコンテナーイメージをフェッチします。

   4

   ミラーレジストリーの URL。ミラーレジストリーを設定する場合は、oc adm release mirror コマンドを実行して、imageContentSources セクションの URL を使用する必要があります。詳細は、OpenShift Container Platform イメージリポジトリーのミラーリング セクションを参照してください。

   5

   registries.conf ファイルで定義されるレジストリーは、レジストリーではなくリポジトリーによってスコープが指定される必要があります。この例では、quay.io/example-repository リポジトリーと mirror1.registry.corp.com:5000/example-repository リポジトリーの両方のスコープが example-repository リポジトリーにより指定されます。

   これにより、以下のように AgentServiceConfig カスタムリソースの mirrorRegistryRef が更新されます。

   出力例

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
     name: agent
     namespace: multicluster-engine 

   1

   
   spec:
     databaseStorage:
       volumeName: <db_pv_name>
       accessModes:
       - ReadWriteOnce
       resources:
         requests:
           storage: <db_storage_size>
     filesystemStorage:
       volumeName: <fs_pv_name>
       accessModes:
       - ReadWriteOnce
       resources:
         requests:
           storage: <fs_storage_size>
     mirrorRegistryRef:
       name: assisted-installer-mirror-config 

   2

   
     osImages:
       - openshiftVersion: <ocp_version> 

   3

   
         url: <iso_url> 

   4

   Copy to Clipboard Toggle word wrap

   1

   ConfigMap namespace と一致するように、AgentServiceConfig namespace を multicluster-engine に設定します。

   2

   関連する ConfigMap CR で指定された定義と一致するように、mirrorRegistryRef.name を設定します。

   3

   OpenShift Container Platform のバージョンを x.y または x.y.z 形式に設定します。

   4

   httpd サーバーでホストされている ISO の URL を設定します。

手順

1. 次のコマンドを実行して、AgentServiceConfig カスタムリソース (CR) を更新します。

   $ oc edit AgentServiceConfig agent

   Copy to Clipboard Toggle word wrap

2. CR に unauthenticatedRegistries フィールドを追加します。

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
     name: agent
   spec:
     unauthenticatedRegistries:
     - example.registry.com
     - example.registry2.com
     ...

   Copy to Clipboard Toggle word wrap

   非認証レジストリーは、AgentServiceConfig リソースの spec.unauthenticatedRegistries の下に一覧表示されます。このリストにあるレジストリーのエントリーは、スポーククラスターのインストールに使用されるプルシークレットに含める必要はありません。assisted-service は、インストールに使用されるすべてのイメージレジストリーの認証情報がプルシークレットに含まれていることを確認して、プルシークレットを検証します。

1. ハブクラスターへのデバッグシェルプロンプトを開きます。

   $ oc debug node/<node_name>

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、非認証レジストリーへのアクセスをテストします。

   sh-4.4# podman login -u kubeadmin -p $(oc whoami -t) <unauthenticated_registry>

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   <unauthenticated_registry>

   unauthenticated-image-registry.openshift-image-registry.svc:5000 などの新しいレジストリーです。

   出力例

   Login Succeeded!

   Copy to Clipboard Toggle word wrap

手順

1. ArgoCD パイプライン設定を準備します。

   1. example ディレクトリーと同様にディレクトリー構造で Git リポジトリーを作成します。詳細は、「GitOps ZTP サイト設定リポジトリーの準備」を参照してください。

   2. ArgoCD UI を使用して、リポジトリーへのアクセスを設定します。Settings で以下を設定します。

      • リポジトリー: 接続情報を追加します。URL は .git などで終わっている必要があります。https://repo.example.com/repo.git と認証情報を指定します。
      • Certificates - 必要に応じて、リポジトリーのパブリック証明書を追加します。

   3. 2 つの ArgoCD アプリケーション、out/argocd/deployment/clusters-app.yaml と out/argocd/deployment/policies-app.yaml を、Git リポジトリーに基づいて修正します。

      • Git リポジトリーを参照するように URL を更新します。URL は .git で終わります (例: https://repo.example.com/repo.git)。
      • targetRevision は、監視する Git リポジトリーブランチを示します。
      • path は、それぞれ SiteConfig および PolicyGenerator または PolicyGentemplate CR へのパスを指定します。

2. GitOps ZTP プラグインをインストールするには、ハブクラスター内の ArgoCD インスタンスに、関連するマルチクラスターエンジン (MCE) サブスクリプションイメージをパッチ適用します。以前に out/argocd/deployment/ ディレクトリーに展開したパッチファイルを環境に合わせてカスタマイズします。

   1. RHACM バージョンに一致する multicluster-operators-subscription イメージを選択します。

      • RHACM 2.8 および 2.9 の場合は、registry.redhat.io/rhacm2/multicluster-operators-subscription-rhel8:v<rhacm_version> イメージを使用します。
      • RHACM 2.10 以降の場合は、registry.redhat.io/rhacm2/multicluster-operators-subscription-rhel9:v<rhacm_version> イメージを使用します。
      重要

      multicluster-operators-subscription イメージのバージョンは、RHACM のバージョンと一致する必要があります。MCE 2.10 リリース以降、RHEL 9 は multicluster-operators-subscription イメージのベースイメージです。

      OpenShift Operator のライフサイクル の表「Platform Aligned Operators」の [Expand for Operator list] をクリックすると、OpenShift Container Platform でサポートされている Operator の完全なマトリックスが表示されます。

   2. RHACM バージョンに一致する multicluster-operators-subscription イメージを使用して、out/argocd/deployment/argocd-openshift-gitops-patch.json ファイルを変更します。

      {
        "args": [
          "-c",
          "mkdir -p /.config/kustomize/plugin/policy.open-cluster-management.io/v1/policygenerator && cp /policy-generator/PolicyGenerator-not-fips-compliant /.config/kustomize/plugin/policy.open-cluster-management.io/v1/policygenerator/PolicyGenerator" 

      1

      
        ],
        "command": [
          "/bin/bash"
        ],
        "image": "registry.redhat.io/rhacm2/multicluster-operators-subscription-rhel9:v2.10", 

      2

      3

      
        "name": "policy-generator-install",
        "imagePullPolicy": "Always",
        "volumeMounts": [
          {
            "mountPath": "/.config",
            "name": "kustomize"
          }
        ]
      }

      Copy to Clipboard Toggle word wrap

      1

      オプション: RHEL 9 イメージの場合、ArgoCD バージョンの /policy-generator/PolicyGenerator-not-fips-compliant フォルダーに必要なユニバーサル実行可能ファイルをコピーします。

      2

      multicluster-operators-subscription イメージを RHACM バージョンに一致させます。

      3

      非接続環境では、multicluster-operators-subscription イメージの URL を、ご使用の環境の非接続レジストリーに相当するものに置き換えます。

   3. ArgoCD インスタンスにパッチを適用します。以下のコマンドを実行します。

      $ oc patch argocd openshift-gitops \
      -n openshift-gitops --type=merge \
      --patch-file out/argocd/deployment/argocd-openshift-gitops-patch.json

      Copy to Clipboard Toggle word wrap

3. RHACM 2.7 以降では、マルチクラスターエンジンはデフォルトで cluster-proxy-addon 機能を有効にします。次のパッチを適用して、cluster-proxy-addon 機能を無効にし、このアドオンに関連するハブクラスターとマネージド Pod を削除します。以下のコマンドを実行します。

   $ oc patch multiclusterengines.multicluster.openshift.io multiclusterengine --type=merge --patch-file out/argocd/deployment/disable-cluster-proxy-addon.json

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、パイプライン設定をハブクラスターに適用します。

   $ oc apply -k out/argocd/deployment

   Copy to Clipboard Toggle word wrap

5. オプション: 既存の ArgoCD アプリケーションがある場合は、次のコマンドを実行して、Application リソースに PrunePropagationPolicy=background ポリシーが設定されていることを確認します。

   $ oc -n openshift-gitops get applications.argoproj.io  \
   clusters -o jsonpath='{.spec.syncPolicy.syncOptions}' |jq

   Copy to Clipboard Toggle word wrap

   既存のポリシーの出力例

   [
     "CreateNamespace=true",
     "PrunePropagationPolicy=background",
     "RespectIgnoreDifferences=true"
   ]

   Copy to Clipboard Toggle word wrap

   1. spec.syncPolicy.syncOption フィールドに PrunePropagationPolicy パラメーターが含まれていない場合、または PrunePropagationPolicy が foreground 値に設定されている場合は、Application リソースでポリシーを background に設定します。以下の例を参照してください。

      kind: Application
      spec:
        syncPolicy:
          syncOptions:
          - PrunePropagationPolicy=background

      Copy to Clipboard Toggle word wrap

   background 削除ポリシーを設定すると、ManagedCluster CR とそれに関連付けられたすべてのリソースが削除されます。

手順

1. SiteConfig と PolicyGenerator または PolicyGentemplate CR 用に個別のパスを持つディレクトリー構造を作成します。

   注記

   SiteConfig と PolicyGenerator または PolicyGentemplate CR を個別のディレクトリーに保存します。SiteConfig ディレクトリーと、PolicyGenerator または PolicyGentemplate ディレクトリーの両方に、そのディレクトリー内のファイルを明示的に含める kustomization.yaml ファイルが含まれている必要があります。

2. 以下のコマンドを使用して ztp-site-generate コンテナーイメージから argocd ディレクトリーをエクスポートします。

   $ podman pull registry.redhat.io/openshift4/ztp-site-generate-rhel8:v4.20

   Copy to Clipboard Toggle word wrap

   $ mkdir -p ./out

   Copy to Clipboard Toggle word wrap

   $ podman run --log-driver=none --rm registry.redhat.io/openshift4/ztp-site-generate-rhel8:v4.20 extract /home/ztp --tar | tar x -C ./out

   Copy to Clipboard Toggle word wrap

3. out ディレクトリーに以下のサブディレクトリーが含まれていることを確認します。

   • out/extra-manifest には、SiteConfig が追加の manifest configMap の生成に使用するソース CR ファイルが含まれます。
   • out/source-crs には、PolicyGenerator が Red Hat Advanced Cluster Management (RHACM) ポリシーを生成するために使用するソース CR ファイルが含まれています。
   • out/argocd/deployment には、この手順の次のステップで使用するハブクラスターに適用するパッチおよび YAML ファイルが含まれます。
   • out/argocd/example には、推奨される設定を表す SiteConfig ファイルと、PolicyGenerator または PolicyGentemplate ファイルのサンプルが含まれています。
4. out/source-crs フォルダーとその内容を PolicyGenerator または PolicyGentemplate ディレクトリーにコピーします。

5. out/extra-manifests ディレクトリーには、RAN DU クラスターの参照マニフェストが含まれています。out/extra-manifests ディレクトリーを SiteConfig フォルダーにコピーします。このディレクトリーには、ztp-site-generate コンテナーからの CR のみを含める必要があります。ユーザー提供の CR をここに追加しないでください。ユーザー提供の CR を使用する場合は、そのコンテンツ用に別のディレクトリーを作成する必要があります。以下に例を示します。

   example/
     ├── acmpolicygenerator
     │   ├── kustomization.yaml
     │   └── source-crs/
     ├── policygentemplates 

   1

   
     │   ├── kustomization.yaml
     │   └── source-crs/
     └── siteconfig
           ├── extra-manifests
           └── kustomization.yaml

   Copy to Clipboard Toggle word wrap

   1

   PolicyGenTemplate CR を使用してポリシーを管理およびデプロイし、クラスターを管理することは、OpenShift Container Platform の今後のリリースでは非推奨になります。Red Hat Advanced Cluster Management (RHACM) および PolicyGenerator CR を使用すると、同等の機能および改善された機能が利用できます。

6. ディレクトリー構造と kustomization.yaml ファイルをコミットし、Git リポジトリーにプッシュします。Git への最初のプッシュには、kustomization.yaml ファイルが含まれている必要があります。

手順

1. SiteConfig CR と PolicyGenerator CR の個別のパスを持つディレクトリー構造を作成します。

2. PolicyGenerator ディレクトリー内に、使用可能にする OpenShift Container Platform バージョンごとにディレクトリーを作成します。バージョンごとに、次のリソースを作成します。

   • そのディレクトリー内のファイルを明示的に含む kustomization.yaml ファイル

   • source-crs ディレクトリーには、ztp-site-generate コンテナーからの参照 CR 設定ファイルが含まれます。

     ユーザー提供の CR を使用する場合は、CR 用に別のディレクトリーを作成する必要があります。

3. /siteconfig ディレクトリーに、使用可能にする OpenShift Container Platform バージョンごとにサブディレクトリーを作成します。バージョンごとに、コンテナーからコピーされる参照 CR 用のディレクトリーを少なくとも 1 つ作成します。ディレクトリーの名前や参照ディレクトリーの数に制限はありません。カスタムマニフェストを使用する場合は、個別のディレクトリーを作成する必要があります。

   次の例では、OpenShift Container Platform のさまざまなバージョンのユーザー提供のマニフェストと CR を使用した構造を説明します。

   ├── acmpolicygenerator
   │   ├── kustomization.yaml 

   1

   
   │   ├── version_4.13 

   2

   
   │   │   ├── common-ranGen.yaml
   │   │   ├── group-du-sno-ranGen.yaml
   │   │   ├── group-du-sno-validator-ranGen.yaml
   │   │   ├── helix56-v413.yaml
   │   │   ├── kustomization.yaml 

   3

   
   │   │   ├── ns.yaml
   │   │   └── source-crs/ 

   4

   
   │   │      └── reference-crs/ 

   5

   
   │   │      └── custom-crs/ 

   6

   
   │   └── version_4.14 

   7

   
   │       ├── common-ranGen.yaml
   │       ├── group-du-sno-ranGen.yaml
   │       ├── group-du-sno-validator-ranGen.yaml
   │       ├── helix56-v414.yaml
   │       ├── kustomization.yaml 

   8

   
   │       ├── ns.yaml
   │       └── source-crs/ 

   9

   
   │         └── reference-crs/ 

   10

   
   │         └── custom-crs/ 

   11

   
   └── siteconfig
       ├── kustomization.yaml
       ├── version_4.13
       │   ├── helix56-v413.yaml
       │   ├── kustomization.yaml
       │   ├── extra-manifest/ 

   12

   
       │   └── custom-manifest/ 

   13

   
       └── version_4.14
           ├── helix57-v414.yaml
           ├── kustomization.yaml
           ├── extra-manifest/ 

   14

   
           └── custom-manifest/ 

   15

   Copy to Clipboard Toggle word wrap

   1

   最上位の kustomization YAML ファイルを作成します。

   2 7

   カスタム /acmpolicygenerator ディレクトリー内にバージョン固有のディレクトリーを作成します。

   3 8

   バージョンごとに kustomization.yaml ファイルを作成します。

   4 9

   ztp-site-generate コンテナーからの参照 CR を含めるために、バージョンごとに source-crs ディレクトリーを作成します。

   5 10

   ZTP コンテナーから展開されるポリシー CR の reference-crs ディレクトリーを作成します。

   6 11

   オプション: ユーザー提供の CR 用に custom-crs ディレクトリーを作成します。

   12 14

   カスタム /siteconfig ディレクトリー内にディレクトリーを作成し、ztp-site-generate コンテナーからの追加のマニフェストを含めます。

   13 15

   ユーザーによって提供されるマニフェストを保持するフォルダーを作成します。

   注記

   前の例では、カスタム /siteconfig ディレクトリー内の各バージョンサブディレクトリーにはさらに 2 つのサブディレクトリーが含まれており、1 つはコンテナーからコピーされた参照マニフェストを含み、もう 1 つは提供するカスタムマニフェスト用です。これらのディレクトリーに割り当てられた名前は一例です。ユーザー提供の CR を使用する場合は、SiteConfig CR の extraManifests.searchPaths の下にリストされている最後のディレクトリーが、ユーザー提供の CR を含むディレクトリーである必要があります。

4. SiteConfig CR を編集して、作成したディレクトリーの検索パスを含めます。extraManifests.searchPaths の下にリストされる最初のディレクトリーは、参照マニフェストを含むディレクトリーである必要があります。ディレクトリーがリストされている順序を考慮してください。ディレクトリーに同じ名前のファイルが含まれている場合は、最後のディレクトリーにあるファイルが優先されます。

   SiteConfig CR の例

   extraManifests:
       searchPaths:
       - extra-manifest/ 

   1

   
       - custom-manifest/ 

   2

   Copy to Clipboard Toggle word wrap

   1

   参照マニフェストを含むディレクトリーは、extraManifests.searchPaths の下に最初にリストされる必要があります。

   2

   ユーザー提供の CR を使用している場合は、SiteConfig CR の extraManifests.searchPaths の下にリストされている最後のディレクトリーが、ユーザー提供の CR を含むディレクトリーである必要があります。

5. トップレベルの kustomization.yaml ファイルを編集して、アクティブな OpenShift Container Platform バージョンを制御します。以下は、最上位レベルの kustomization.yaml ファイルの例です。

   resources:
   - version_4.13 

   1

   
   #- version_4.14 

   2

   Copy to Clipboard Toggle word wrap

   1

   バージョン 4.13 をアクティブ化します。

   2

   コメントを使用してバージョンを非アクティブ化します。

手順

1. cluster.open-cluster-management.io/backup=cluster-activation ラベルを infraenvs.agent-install.openshift.io ラベルの付いたすべての BareMetalHost リソースに追加するポリシーを作成します。ポリシーを BareMetalHostBackupPolicy.yaml として保存します。

   以下の例では、cluster.open-cluster-management.io/backup ラベルを、infraenvs.agent-install.openshift.io ラベルの付いたすべての BareMetalHost リソースに追加します。

   ポリシーの例

   apiVersion: policy.open-cluster-management.io/v1
   kind: Policy
   metadata:
     name: bmh-cluster-activation-label
     annotations:
       policy.open-cluster-management.io/description: Policy used to add the cluster.open-cluster-management.io/backup=cluster-activation label to all BareMetalHost resources
   spec:
     disabled: false
     policy-templates:
       - objectDefinition:
           apiVersion: policy.open-cluster-management.io/v1
           kind: ConfigurationPolicy
           metadata:
             name: set-bmh-backup-label
           spec:
             object-templates-raw: |
               {{- /* Set cluster-activation label on all BMH resources */ -}}
               {{- $infra_label := "infraenvs.agent-install.openshift.io" }}
               {{- range $bmh := (lookup "metal3.io/v1alpha1" "BareMetalHost" "" "" $infra_label).items }}
                   - complianceType: musthave
                     objectDefinition:
                       kind: BareMetalHost
                       apiVersion: metal3.io/v1alpha1
                       metadata:
                         name: {{ $bmh.metadata.name }}
                         namespace: {{ $bmh.metadata.namespace }}
                         labels:
                           cluster.open-cluster-management.io/backup: cluster-activation 

   1

   
               {{- end }}
             remediationAction: enforce
             severity: high
   ---
   apiVersion: cluster.open-cluster-management.io/v1beta1
   kind: Placement
   metadata:
     name: bmh-cluster-activation-label-pr
   spec:
     predicates:
       - requiredClusterSelector:
           labelSelector:
             matchExpressions:
               - key: name
                 operator: In
                 values:
                   - local-cluster
   ---
   apiVersion: policy.open-cluster-management.io/v1
   kind: PlacementBinding
   metadata:
     name: bmh-cluster-activation-label-binding
   placementRef:
     name: bmh-cluster-activation-label-pr
     apiGroup: cluster.open-cluster-management.io
     kind: Placement
   subjects:
     - name: bmh-cluster-activation-label
       apiGroup: policy.open-cluster-management.io
       kind: Policy
   ---
   apiVersion: cluster.open-cluster-management.io/v1beta2
   kind: ManagedClusterSetBinding
   metadata:
     name: default
     namespace: default
   spec:
     clusterSet: default

   Copy to Clipboard Toggle word wrap

   1

   cluster.open-cluster-management.io/backup: cluster-activation ラベルを BareMetalHost リソースに適用すると、RHACM クラスターはそれらのリソースをバックアップします。ハブアクティベーションリソースを復元する際に、アクティブなクラスターが使用できなくなった場合は、BareMetalHost リソースを復元できます。

2. 以下のコマンドを実行してポリシーを適用します。

   $ oc apply -f BareMetalHostBackupPolicy.yaml

   Copy to Clipboard Toggle word wrap

検証

1. 以下のコマンドを実行して、ラベル infraenvs.agent-install.openshift.io を持つすべての BareMetalHost リソースを検索します。

   $ oc get BareMetalHost -A -l infraenvs.agent-install.openshift.io

   Copy to Clipboard Toggle word wrap

   出力例

   NAMESPACE      NAME             STATE   CONSUMER   ONLINE   ERROR   AGE
   baremetal-ns   baremetal-name                      false            50s

   Copy to Clipboard Toggle word wrap

2. 以下のコマンドを実行して、ポリシーがラベル cluster.open-cluster-management.io/backup=cluster-activation をこれらのリソースすべてに適用していることを確認します。

   $ oc get BareMetalHost -A -l infraenvs.agent-install.openshift.io,cluster.open-cluster-management.io/backup=cluster-activation

   Copy to Clipboard Toggle word wrap

   出力例

   NAMESPACE      NAME             STATE   CONSUMER   ONLINE   ERROR   AGE
   baremetal-ns   baremetal-name                      false            50s

   Copy to Clipboard Toggle word wrap

   出力には、前の手順と同じリストが表示されるはずです。このリストには、ラベル infraenvs.agent-install.openshift.io が付いたすべての BareMetalHost リソースが表示されています。これにより、infraenvs.agent-install.openshift.io ラベルが付いたすべての BareMetalHost リソースに、cluster.open-cluster-management.io/backup: cluster-activation ラベルも付いていることが確認されます。

   以下の例は、infraenvs.agent-install.openshift.io ラベルの付いた BareMetalHost リソースを示しています。リソースには、ステップ 1 で作成したポリシーによって追加された cluster.open-cluster-management.io/backup: cluster-activation ラベルも必要です。

   apiVersion: metal3.io/v1alpha1
   kind: BareMetalHost
   metadata:
     labels:
       cluster.open-cluster-management.io/backup: cluster-activation
       infraenvs.agent-install.openshift.io: value
     name: baremetal-name
     namespace: baremetal-ns

   Copy to Clipboard Toggle word wrap

1. 既存のすべてのクラスターに ztp-done ラベルを付けます。
2. ArgoCD アプリケーションを停止します。
3. 新しい GitOps ZTP ツールをインストールします。
4. Git リポジトリーで必要なコンテンツおよびオプションの変更を更新します。
5. 必要な OpenShift Container Platform バージョンの ISO イメージのプルを有効にします。
6. アプリケーション設定を更新して再起動します。

手順

1. GitOps ZTP で使用するために Red Hat OpenShift GitOps の設定に使用されるカスタムリソース (CR) を持つ GitOps ZTP コンテナーの最新バージョンを取得します。

2. 次のコマンドを使用して、argocd/deployment ディレクトリーを抽出します。

   $ mkdir -p ./update

   Copy to Clipboard Toggle word wrap

   $ podman run --log-driver=none --rm registry.redhat.io/openshift4/ztp-site-generate-rhel8:v4.20 extract /home/ztp --tar | tar x -C ./update

   Copy to Clipboard Toggle word wrap

   /update ディレクトリーには、次のサブディレクトリーが含まれています。

   • update/extra-manifest: SiteConfig CR が追加のマニフェスト configMap を生成するために使用するソース CR ファイルが含まれています。
   • update/source-crs: PolicyGenerator または PolicyGentemplate CR が Red Hat Advanced Cluster Management (RHACM) ポリシーを生成するために使用するソース CR ファイルが含まれます。
   • update/argocd/deployment には、この手順の次のステップで使用するハブクラスターに適用するパッチおよび YAML ファイルが含まれます。
   • update/argocd/example: 推奨される設定を表す SiteConfig と、PolicyGenerator または PolicyGentemplate ファイルの例が含まれています。

3. clusters-app.yaml ファイルおよび policies-app.yaml ファイルを更新して、Git リポジトリーのアプリケーションおよび URL、ブランチ、およびパスを反映します。

   アップグレードにポリシーの廃止につながる変更が含まれている場合は、アップグレードを実行する前に、廃止されたポリシーを削除する必要があります。

4. /update フォルダー内の設定およびデプロイソース CR と、フリートサイト CR を管理する Git リポジトリーとの間の変更を比較します。必要な変更をサイトリポジトリーに適用してプッシュします。

   重要

   GitOps ZTP を最新バージョンに更新するときは、update/argocd/deployment ディレクトリーからサイトリポジトリーに変更を適用する必要があります。古いバージョンの argocd/deployment/ ファイルは使用しないでください。

手順

1. local-cluster!=true など、GitOps Zero Touch Provisioning (ZTP) でデプロイされたマネージドクラスターを一覧表示するラベルセレクターを見つけます。

   $ oc get managedcluster -l 'local-cluster!=true'

   Copy to Clipboard Toggle word wrap

2. 結果のリストに、GitOps ZTP でデプロイされたすべてのマネージドクラスターが含まれていることを確認してから、そのセレクターを使用して ztp-done ラベルを追加します。

   $ oc label managedcluster -l 'local-cluster!=true' ztp-done=

   Copy to Clipboard Toggle word wrap

手順

1. clusters アプリケーションで非カスケード削除を実行して、生成されたすべてのリソースをそのまま残します。

   $ oc delete -f update/argocd/deployment/clusters-app.yaml

   Copy to Clipboard Toggle word wrap

2. policies アプリケーションでカスケード削除を実行して、以前のすべてのポリシーを削除します。

   $ oc patch -f policies-app.yaml -p '{"metadata": {"finalizers": ["resources-finalizer.argocd.argoproj.io"]}}' --type merge

   Copy to Clipboard Toggle word wrap

   $ oc delete -f update/argocd/deployment/policies-app.yaml

   Copy to Clipboard Toggle word wrap

手順

1. GitOps ZTP プラグインをインストールするには、ハブクラスター内の ArgoCD インスタンスに、関連するマルチクラスターエンジン (MCE) サブスクリプションイメージをパッチ適用します。以前に out/argocd/deployment/ ディレクトリーに展開したパッチファイルを環境に合わせてカスタマイズします。

   1. RHACM バージョンに一致する multicluster-operators-subscription イメージを選択します。

      • RHACM 2.8 および 2.9 の場合は、registry.redhat.io/rhacm2/multicluster-operators-subscription-rhel8:v<rhacm_version> イメージを使用します。
      • RHACM 2.10 以降の場合は、registry.redhat.io/rhacm2/multicluster-operators-subscription-rhel9:v<rhacm_version> イメージを使用します。
      重要

      multicluster-operators-subscription イメージのバージョンは、RHACM のバージョンと一致する必要があります。MCE 2.10 リリース以降、RHEL 9 は multicluster-operators-subscription イメージのベースイメージです。

      OpenShift Operator のライフサイクル の表「Platform Aligned Operators」の [Expand for Operator list] をクリックすると、OpenShift Container Platform でサポートされている Operator の完全なマトリックスが表示されます。

   2. RHACM バージョンに一致する multicluster-operators-subscription イメージを使用して、out/argocd/deployment/argocd-openshift-gitops-patch.json ファイルを変更します。

      {
        "args": [
          "-c",
          "mkdir -p /.config/kustomize/plugin/policy.open-cluster-management.io/v1/policygenerator && cp /policy-generator/PolicyGenerator-not-fips-compliant /.config/kustomize/plugin/policy.open-cluster-management.io/v1/policygenerator/PolicyGenerator" 

      1

      
        ],
        "command": [
          "/bin/bash"
        ],
        "image": "registry.redhat.io/rhacm2/multicluster-operators-subscription-rhel9:v2.10", 

      2

      3

      
        "name": "policy-generator-install",
        "imagePullPolicy": "Always",
        "volumeMounts": [
          {
            "mountPath": "/.config",
            "name": "kustomize"
          }
        ]
      }

      Copy to Clipboard Toggle word wrap

      1

      オプション: RHEL 9 イメージの場合、ArgoCD バージョンの /policy-generator/PolicyGenerator-not-fips-compliant フォルダーに必要なユニバーサル実行可能ファイルをコピーします。

      2

      multicluster-operators-subscription イメージを RHACM バージョンに一致させます。

      3

      非接続環境では、multicluster-operators-subscription イメージの URL を、ご使用の環境の非接続レジストリーに相当するものに置き換えます。

   3. ArgoCD インスタンスにパッチを適用します。以下のコマンドを実行します。

      $ oc patch argocd openshift-gitops \
      -n openshift-gitops --type=merge \
      --patch-file out/argocd/deployment/argocd-openshift-gitops-patch.json

      Copy to Clipboard Toggle word wrap

2. RHACM 2.7 以降では、マルチクラスターエンジンはデフォルトで cluster-proxy-addon 機能を有効にします。次のパッチを適用して、cluster-proxy-addon 機能を無効にし、このアドオンに関連するハブクラスターとマネージド Pod を削除します。以下のコマンドを実行します。

   $ oc patch multiclusterengines.multicluster.openshift.io multiclusterengine --type=merge --patch-file out/argocd/deployment/disable-cluster-proxy-addon.json

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、パイプライン設定をハブクラスターに適用します。

   $ oc apply -k out/argocd/deployment

   Copy to Clipboard Toggle word wrap

手順

1. spec.osImages フィールドを更新するために、次のコマンドを実行して AgentServiceConfig CR を開きます。

   $ oc edit AgentServiceConfig

   Copy to Clipboard Toggle word wrap

2. AgentServiceConfig CR の spec.osImages フィールドを更新します。

   apiVersion: agent-install.openshift.io/v1beta1
   kind: AgentServiceConfig
   metadata:
    name: agent
   spec:
   # ...
     osImages:
       - cpuArchitecture: x86_64
         openshiftVersion: "4.20"
         rootFSUrl: https://<host>/<path>/rhcos-live-rootfs.x86_64.img
         url: https://<host>/<path>/rhcos-live.x86_64.iso

   Copy to Clipboard Toggle word wrap

   ここでは、以下のようになります。

   <host>

   ターゲットミラーレジストリー HTTP サーバーの完全修飾ドメイン名 (FQDN) を指定します。

   <path>

   ターゲットミラーレジストリー上のイメージへのパスを指定します。

3. エディターを保存して終了し、変更を適用します。

手順

1. ホスト Baseboard Management Controller (BMC) の認証情報と、OpenShift およびすべてのアドオンクラスター Operator のインストールに必要なプルシークレットを含む YAML シークレットファイルを作成します。

   1. 次の YAML をファイル example-sno-secret.yaml として保存します。

      apiVersion: v1
      kind: Secret
      metadata:
        name: example-sno-bmc-secret
        namespace: example-sno 

      1

      
      data: 

      2

      
        password: <base64_password>
        username: <base64_username>
      type: Opaque
      ---
      apiVersion: v1
      kind: Secret
      metadata:
        name: pull-secret
        namespace: example-sno  

      3

      
      data:
        .dockerconfigjson: <pull_secret> 

      4

      
      type: kubernetes.io/dockerconfigjson

      Copy to Clipboard Toggle word wrap

      1

      関連する SiteConfig CR で設定された namespace と一致する必要があります

      2

      password と username の Base64 エンコード値

      3

      関連する SiteConfig CR で設定された namespace と一致する必要があります

      4

      Base64 でエンコードされたプルシークレット

2. example-sno-secret.yaml への相対パスを、クラスターのインストールに使用する kustomization.yaml ファイルに追加します。

手順

1. InfraEnv CR を作成し、spec.kernelArguments 仕様を編集してカーネル引数を設定します。

   1. 次の YAML を InfraEnv-example.yaml ファイルに保存します。

      注記

      この例の InfraEnv CR は、SiteConfig CR の値に基づいて入力される {{ .Cluster.ClusterName }} などのテンプレート構文を使用します。SiteConfig CR は、デプロイメント中にこれらのテンプレートの値を自動的に設定します。テンプレートを手動で編集しないでください。

      apiVersion: agent-install.openshift.io/v1beta1
      kind: InfraEnv
      metadata:
        annotations:
          argocd.argoproj.io/sync-wave: "1"
        name: "{{ .Cluster.ClusterName }}"
        namespace: "{{ .Cluster.ClusterName }}"
      spec:
        clusterRef:
          name: "{{ .Cluster.ClusterName }}"
          namespace: "{{ .Cluster.ClusterName }}"
        kernelArguments:
          - operation: append 

      1

      
            value: audit=0 

      2

      
          - operation: append
            value: trace=1
        sshAuthorizedKey: "{{ .Site.SshPublicKey }}"
        proxy: "{{ .Cluster.ProxySettings }}"
        pullSecretRef:
          name: "{{ .Site.PullSecretRef.Name }}"
        ignitionConfigOverride: "{{ .Cluster.IgnitionConfigOverride }}"
        nmStateConfigLabelSelector:
          matchLabels:
            nmstate-label: "{{ .Cluster.ClusterName }}"
        additionalNTPSources: "{{ .Cluster.AdditionalNTPSources }}"

      Copy to Clipboard Toggle word wrap

      1

      カーネル引数を追加するには、追加操作を指定します。

      2

      設定するカーネル引数を指定します。この例では、audit カーネル引数と trace カーネル引数を設定します。

2. InfraEnv-example.yaml CR を、Git リポジトリー内の SiteConfig CR と同じ場所にコミットし、変更をプッシュします。次の例は、サンプルの Git リポジトリー構造を示しています。

   ~/example-ztp/install
             └── site-install
                  ├── siteconfig-example.yaml
                  ├── InfraEnv-example.yaml
                  ...

   Copy to Clipboard Toggle word wrap

3. SiteConfig CR の spec.clusters.crTemplates 仕様を編集して、Git リポジトリーの InfraEnv-example.yaml CR を参照します。

   clusters:
     crTemplates:
       InfraEnv: "InfraEnv-example.yaml"

   Copy to Clipboard Toggle word wrap

   SiteConfig CR をコミットおよびプッシュしてクラスターをデプロイする準備ができたら、ビルドパイプラインは Git リポジトリー内のカスタム InfraEnv-example CR を使用して、カスタムカーネル引数を含むインフラストラクチャー環境を設定します。

1. ターゲットホストとの SSH セッションを開始します。

   $ ssh -i /path/to/privatekey core@<host_name>

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを使用して、システムのカーネル引数を表示します。

   $ cat /proc/cmdline

   Copy to Clipboard Toggle word wrap

1. Assisted Service Operator は OpenShift Container Platform をクラスターにインストールします。次のコマンドを実行して、RHACM ダッシュボードまたはコマンドラインからクラスターのインストールの進行状況を監視できます。

   1. クラスター名をエクスポートします。

      $ export CLUSTER=<clusterName>

      Copy to Clipboard Toggle word wrap

   2. マネージドクラスターの AgentClusterInstall CR をクエリーします。

      $ oc get agentclusterinstall -n $CLUSTER $CLUSTER -o jsonpath='{.status.conditions[?(@.type=="Completed")]}' | jq

      Copy to Clipboard Toggle word wrap

   3. クラスターのインストールイベントを取得します。

      $ curl -sk $(oc get agentclusterinstall -n $CLUSTER $CLUSTER -o jsonpath='{.status.debugInfo.eventsURL}')  | jq '.[-2,-1]'

      Copy to Clipboard Toggle word wrap

手順

1. インストール CR が作成されたことは、以下のコマンドで確認することができます。

   $ oc get AgentClusterInstall -n <cluster_name>

   Copy to Clipboard Toggle word wrap

   オブジェクトが返されない場合は、以下の手順を使用して ArgoCD パイプラインフローを SiteConfig ファイルからインストール CR にトラブルシューティングします。

2. ハブクラスターで SiteConfig CR を使用して ManagedCluster CR が生成されたことを確認します。

   $ oc get managedcluster

   Copy to Clipboard Toggle word wrap

3. ManagedCluster が見つからない場合は、clusters アプリケーションが Git リポジトリーからハブクラスターへのファイルの同期に失敗したかどうかを確認します。

   $ oc get applications.argoproj.io -n openshift-gitops clusters -o yaml

   Copy to Clipboard Toggle word wrap

   1. マネージドクラスターのエラーログを識別するには、status.operationState.syncResult.resources フィールドを調べます。たとえば、SiteConfig CR の extraManifestPath に無効な値が割り当てられると、次のようなエラーが生成されます。

      syncResult:
        resources:
        - group: ran.openshift.io
          kind: SiteConfig
          message: The Kubernetes API could not find ran.openshift.io/SiteConfig for
            requested resource spoke-sno/spoke-sno. Make sure the "SiteConfig" CRD is
            installed on the destination cluster

      Copy to Clipboard Toggle word wrap

   2. より詳細な SiteConfig エラーを表示するには、次の手順を実行します。

      1. Argo CD ダッシュボードで、Argo CD が同期しようとしている SiteConfig リソースをクリックします。

      2. DESIRED MANIFEST タブをチェックして、siteConfigError フィールドを見つけます。

         siteConfigError: >- Error: could not build the entire SiteConfig defined by /tmp/kust-plugin-config-1081291903: stat sno-extra-manifest: no such file or directory

         Copy to Clipboard Toggle word wrap

   3. Status.Sync フィールドを確認します。ログエラーがある場合、Status.Sync フィールドは Unknown エラーを示している可能性があります。

      Status:
        Sync:
          Compared To:
            Destination:
              Namespace:  clusters-sub
              Server:     https://kubernetes.default.svc
            Source:
              Path:             sites-config
              Repo URL:         https://git.com/ran-sites/siteconfigs/.git
              Target Revision:  master
          Status:               Unknown

      Copy to Clipboard Toggle word wrap

手順

1. 次のコマンドを実行して、Provisioning リソースの TLS を無効にします。

   $ oc patch provisioning provisioning-configuration --type merge -p '{"spec":{"disableVirtualMediaTLS": true}}'

   Copy to Clipboard Toggle word wrap
2. シングルノード OpenShift クラスターをデプロイする手順を続行します。

手順

1. kustomization.yaml ファイルから、関連する SiteConfig と、PolicyGenerator または PolicyGentemplate ファイルを削除して、サイトと関連する CR を削除します。

2. 次の syncOptions フィールドを SiteConfig アプリケーションに追加します。

   kind: Application
   spec:
     syncPolicy:
       syncOptions:
       - PrunePropagationPolicy=background

   Copy to Clipboard Toggle word wrap

   GitOps ZTP パイプラインを再度実行すると、生成された CR は削除されます。

3. オプション: サイトを完全に削除する場合は、SiteConfig と、サイト固有の PolicyGenerator または PolicyGentemplate ファイルも Git リポジトリーから削除する必要があります。
4. オプション: サイトを再デプロイする場合など、一時的にサイトを削除する場合は、SiteConfig とサイト固有の PolicyGenerator または PolicyGentemplate CR を Git リポジトリーに残しておくことができます。

手順

1. 影響を受ける PolicyGenerator または PolicyGentemplate ファイルを Git リポジトリーから削除し、コミットしてリモートリポジトリーにプッシュします。
2. アプリケーションを介して変更が同期され、影響を受けるポリシーがハブクラスターから削除されるのを待ちます。

3. 更新された PolicyGenerator または PolicyGentemplate ファイルを Git リポジトリーに再び追加し、コミットしてリモートリポジトリーにプッシュします。

   注記

   Git リポジトリーから GitOps Zero Touch Provisioning (ZTP) ポリシーを削除し、その結果としてハブクラスターからもポリシーが削除されても、マネージドクラスターの設定には影響しません。ポリシーとそのポリシーによって管理される CR は、マネージドクラスターに残ります。

4. オプション: 別の方法として、PolicyGenerator または PolicyGentemplate CR に変更を加えたことでポリシーが古くなった場合は、これらのポリシーをハブクラスターから手動で削除できます。ポリシーの削除は、RHACM コンソールから Governance タブを使用するか、以下のコマンドを使用して行うことができます。

   $ oc delete policy -n <namespace> <policy_name>

   Copy to Clipboard Toggle word wrap

手順

1. ハブクラスターの Red Hat Advanced Cluster Management (RHACM) からすべてのクラスターを切り離します。

2. 次のコマンドを使用して、deployment ディレクトリーの kustomization.yaml ファイルを削除します。

   $ oc delete -k out/argocd/deployment

   Copy to Clipboard Toggle word wrap
3. 変更をコミットして、サイトリポジトリーにプッシュします。