16.7. コンテナーイメージ事前キャッシュ機能の使用

手順

1. clustergroupupgrades-group-du.yaml ファイルで preCaching フィールドを true に設定して ClusterGroupUpgrade CR の内容を保存します。

   apiVersion: ran.openshift.io/v1alpha1
   kind: ClusterGroupUpgrade
   metadata:
     name: du-upgrade-4918
     namespace: ztp-group-du-sno
   spec:
     preCaching: true 1
     clusters:
     - cnfdb1
     - cnfdb2
     enable: false
     managedPolicies:
     - du-upgrade-platform-upgrade
     remediationStrategy:
       maxConcurrency: 2
       timeout: 240

   1

   preCaching フィールドは true に設定されています。これにより、更新を開始する前に TALM がコンテナーイメージをプルできます。

2. 更新を開始する場合は、以下のコマンドを実行して ClusterGroupUpgrade CR を適用します。

   $ oc apply -f clustergroupupgrades-group-du.yaml

検証

1. 以下のコマンドを実行して、ClusterGroupUpgrade CR がハブクラスターに存在するかどうかを確認します。

   $ oc get cgu -A

   出力例

   NAMESPACE          NAME              AGE
   ztp-group-du-sno   du-upgrade-4918   10s 1

   1

   CR が作成されます。

2. 以下のコマンドを実行して、事前キャッシュタスクのステータスを確認します。

   $ oc get cgu -n ztp-group-du-sno du-upgrade-4918 -o jsonpath='{.status}'

   出力例

   {
     "conditions": [
       {
         "lastTransitionTime": "2022-01-27T19:07:24Z",
         "message": "Precaching is not completed (required)", 1
         "reason": "PrecachingRequired",
         "status": "False",
         "type": "Ready"
       },
       {
         "lastTransitionTime": "2022-01-27T19:07:24Z",
         "message": "Precaching is required and not done",
         "reason": "PrecachingNotDone",
         "status": "False",
         "type": "PrecachingDone"
       },
       {
         "lastTransitionTime": "2022-01-27T19:07:34Z",
         "message": "Pre-caching spec is valid and consistent",
         "reason": "PrecacheSpecIsWellFormed",
         "status": "True",
         "type": "PrecacheSpecValid"
       }
     ],
     "precaching": {
       "clusters": [
         "cnfdb1" 2
       ],
       "spec": {
         "platformImage": "image.example.io"},
       "status": {
         "cnfdb1": "Active"}
       }
   }

   1

   更新中であることを表示します。

   2

   特定されたクラスターのリストを表示します。

3. スポーククラスターで以下のコマンドを実行して、事前キャッシュジョブのステータスを確認します。

   $ oc get jobs,pods -n openshift-talm-pre-cache

   出力例

   NAME                  COMPLETIONS   DURATION   AGE
   job.batch/pre-cache   0/1           3m10s      3m10s
   
   NAME                     READY   STATUS    RESTARTS   AGE
   pod/pre-cache--1-9bmlr   1/1     Running   0          3m10s

4. 以下のコマンドを実行して ClusterGroupUpgrade CR のステータスを確認します。

   $ oc get cgu -n ztp-group-du-sno du-upgrade-4918 -o jsonpath='{.status}'

   出力例

   "conditions": [
       {
         "lastTransitionTime": "2022-01-27T19:30:41Z",
         "message": "The ClusterGroupUpgrade CR has all clusters compliant with all the managed policies",
         "reason": "UpgradeCompleted",
         "status": "True",
         "type": "Ready"
       },
       {
         "lastTransitionTime": "2022-01-27T19:28:57Z",
         "message": "Precaching is completed",
         "reason": "PrecachingCompleted",
         "status": "True",
         "type": "PrecachingDone" 1
       }

   1

   キャッシュ前のタスクが実行されます。