18.11. 토폴로지 Aware Lifecycle Manager를 사용하여 관리형 클러스터 업데이트

프로세스

1. ClusterGroupUpgrade CR의 내용을 cgu-a.yaml,cgu-b.yaml 및 cgu-c.yaml 파일에 저장합니다.

   apiVersion: ran.openshift.io/v1alpha1
   kind: ClusterGroupUpgrade
   metadata:
     name: cgu-a
     namespace: default
   spec:
     blockingCRs: 1
     - name: cgu-c
       namespace: default
     clusters:
     - spoke1
     - spoke2
     - spoke3
     enable: false
     managedPolicies:
     - policy1-common-cluster-version-policy
     - policy2-common-pao-sub-policy
     - policy3-common-ptp-sub-policy
     remediationStrategy:
       canaries:
       - spoke1
       maxConcurrency: 2
       timeout: 240
   status:
     conditions:
     - message: The ClusterGroupUpgrade CR is not enabled
       reason: UpgradeNotStarted
       status: "False"
       type: Ready
     copiedPolicies:
     - cgu-a-policy1-common-cluster-version-policy
     - cgu-a-policy2-common-pao-sub-policy
     - cgu-a-policy3-common-ptp-sub-policy
     managedPoliciesForUpgrade:
     - name: policy1-common-cluster-version-policy
       namespace: default
     - name: policy2-common-pao-sub-policy
       namespace: default
     - name: policy3-common-ptp-sub-policy
       namespace: default
     placementBindings:
     - cgu-a-policy1-common-cluster-version-policy
     - cgu-a-policy2-common-pao-sub-policy
     - cgu-a-policy3-common-ptp-sub-policy
     placementRules:
     - cgu-a-policy1-common-cluster-version-policy
     - cgu-a-policy2-common-pao-sub-policy
     - cgu-a-policy3-common-ptp-sub-policy
     remediationPlan:
     - - spoke1
     - - spoke2

   1

   blocking CR을 정의합니다. cgu-a 업데이트는 cgu-c 가 완료될 때까지 시작할 수 없습니다.

   apiVersion: ran.openshift.io/v1alpha1
   kind: ClusterGroupUpgrade
   metadata:
     name: cgu-b
     namespace: default
   spec:
     blockingCRs: 1
     - name: cgu-a
       namespace: default
     clusters:
     - spoke4
     - spoke5
     enable: false
     managedPolicies:
     - policy1-common-cluster-version-policy
     - policy2-common-pao-sub-policy
     - policy3-common-ptp-sub-policy
     - policy4-common-sriov-sub-policy
     remediationStrategy:
       maxConcurrency: 1
       timeout: 240
   status:
     conditions:
     - message: The ClusterGroupUpgrade CR is not enabled
       reason: UpgradeNotStarted
       status: "False"
       type: Ready
     copiedPolicies:
     - cgu-b-policy1-common-cluster-version-policy
     - cgu-b-policy2-common-pao-sub-policy
     - cgu-b-policy3-common-ptp-sub-policy
     - cgu-b-policy4-common-sriov-sub-policy
     managedPoliciesForUpgrade:
     - name: policy1-common-cluster-version-policy
       namespace: default
     - name: policy2-common-pao-sub-policy
       namespace: default
     - name: policy3-common-ptp-sub-policy
       namespace: default
     - name: policy4-common-sriov-sub-policy
       namespace: default
     placementBindings:
     - cgu-b-policy1-common-cluster-version-policy
     - cgu-b-policy2-common-pao-sub-policy
     - cgu-b-policy3-common-ptp-sub-policy
     - cgu-b-policy4-common-sriov-sub-policy
     placementRules:
     - cgu-b-policy1-common-cluster-version-policy
     - cgu-b-policy2-common-pao-sub-policy
     - cgu-b-policy3-common-ptp-sub-policy
     - cgu-b-policy4-common-sriov-sub-policy
     remediationPlan:
     - - spoke4
     - - spoke5
     status: {}

   1

   cgu-b 업데이트는 cgu-a 가 완료될 때까지 시작할 수 없습니다.

   apiVersion: ran.openshift.io/v1alpha1
   kind: ClusterGroupUpgrade
   metadata:
     name: cgu-c
     namespace: default
   spec: 1
     clusters:
     - spoke6
     enable: false
     managedPolicies:
     - policy1-common-cluster-version-policy
     - policy2-common-pao-sub-policy
     - policy3-common-ptp-sub-policy
     - policy4-common-sriov-sub-policy
     remediationStrategy:
       maxConcurrency: 1
       timeout: 240
   status:
     conditions:
     - message: The ClusterGroupUpgrade CR is not enabled
       reason: UpgradeNotStarted
       status: "False"
       type: Ready
     copiedPolicies:
     - cgu-c-policy1-common-cluster-version-policy
     - cgu-c-policy4-common-sriov-sub-policy
     managedPoliciesCompliantBeforeUpgrade:
     - policy2-common-pao-sub-policy
     - policy3-common-ptp-sub-policy
     managedPoliciesForUpgrade:
     - name: policy1-common-cluster-version-policy
       namespace: default
     - name: policy4-common-sriov-sub-policy
       namespace: default
     placementBindings:
     - cgu-c-policy1-common-cluster-version-policy
     - cgu-c-policy4-common-sriov-sub-policy
     placementRules:
     - cgu-c-policy1-common-cluster-version-policy
     - cgu-c-policy4-common-sriov-sub-policy
     remediationPlan:
     - - spoke6
     status: {}

   1

   cgu-c 업데이트에는 차단 CR이 없습니다. enable 필드가 true 로 설정된 경우 TALM은 cgu-c 업데이트를 시작합니다.

2. 각 관련 CR에 대해 다음 명령을 실행하여 ClusterGroupUpgrade CR을 생성합니다.

   $ oc apply -f <name>.yaml

3. 각 관련 CR에 대해 다음 명령을 실행하여 업데이트 프로세스를 시작합니다.

   $ oc --namespace=default patch clustergroupupgrade.ran.openshift.io/<name> \
   --type merge -p '{"spec":{"enable":true}}'

   다음 예제에서는 enable 필드가 true 로 설정된 ClusterGroupUpgrade CR을 보여줍니다.

   CR 차단이 있는 cgu-a 의 예

   apiVersion: ran.openshift.io/v1alpha1
   kind: ClusterGroupUpgrade
   metadata:
     name: cgu-a
     namespace: default
   spec:
     blockingCRs:
     - name: cgu-c
       namespace: default
     clusters:
     - spoke1
     - spoke2
     - spoke3
     enable: true
     managedPolicies:
     - policy1-common-cluster-version-policy
     - policy2-common-pao-sub-policy
     - policy3-common-ptp-sub-policy
     remediationStrategy:
       canaries:
       - spoke1
       maxConcurrency: 2
       timeout: 240
   status:
     conditions:
     - message: 'The ClusterGroupUpgrade CR is blocked by other CRs that have not yet
         completed: [cgu-c]' 1
       reason: UpgradeCannotStart
       status: "False"
       type: Ready
     copiedPolicies:
     - cgu-a-policy1-common-cluster-version-policy
     - cgu-a-policy2-common-pao-sub-policy
     - cgu-a-policy3-common-ptp-sub-policy
     managedPoliciesForUpgrade:
     - name: policy1-common-cluster-version-policy
       namespace: default
     - name: policy2-common-pao-sub-policy
       namespace: default
     - name: policy3-common-ptp-sub-policy
       namespace: default
     placementBindings:
     - cgu-a-policy1-common-cluster-version-policy
     - cgu-a-policy2-common-pao-sub-policy
     - cgu-a-policy3-common-ptp-sub-policy
     placementRules:
     - cgu-a-policy1-common-cluster-version-policy
     - cgu-a-policy2-common-pao-sub-policy
     - cgu-a-policy3-common-ptp-sub-policy
     remediationPlan:
     - - spoke1
     - - spoke2
     status: {}

   1

   차단 CR 목록을 표시합니다.

   CR 차단이 있는 cgu-b 의 예

   apiVersion: ran.openshift.io/v1alpha1
   kind: ClusterGroupUpgrade
   metadata:
     name: cgu-b
     namespace: default
   spec:
     blockingCRs:
     - name: cgu-a
       namespace: default
     clusters:
     - spoke4
     - spoke5
     enable: true
     managedPolicies:
     - policy1-common-cluster-version-policy
     - policy2-common-pao-sub-policy
     - policy3-common-ptp-sub-policy
     - policy4-common-sriov-sub-policy
     remediationStrategy:
       maxConcurrency: 1
       timeout: 240
   status:
     conditions:
     - message: 'The ClusterGroupUpgrade CR is blocked by other CRs that have not yet
         completed: [cgu-a]' 1
       reason: UpgradeCannotStart
       status: "False"
       type: Ready
     copiedPolicies:
     - cgu-b-policy1-common-cluster-version-policy
     - cgu-b-policy2-common-pao-sub-policy
     - cgu-b-policy3-common-ptp-sub-policy
     - cgu-b-policy4-common-sriov-sub-policy
     managedPoliciesForUpgrade:
     - name: policy1-common-cluster-version-policy
       namespace: default
     - name: policy2-common-pao-sub-policy
       namespace: default
     - name: policy3-common-ptp-sub-policy
       namespace: default
     - name: policy4-common-sriov-sub-policy
       namespace: default
     placementBindings:
     - cgu-b-policy1-common-cluster-version-policy
     - cgu-b-policy2-common-pao-sub-policy
     - cgu-b-policy3-common-ptp-sub-policy
     - cgu-b-policy4-common-sriov-sub-policy
     placementRules:
     - cgu-b-policy1-common-cluster-version-policy
     - cgu-b-policy2-common-pao-sub-policy
     - cgu-b-policy3-common-ptp-sub-policy
     - cgu-b-policy4-common-sriov-sub-policy
     remediationPlan:
     - - spoke4
     - - spoke5
     status: {}

   1

   차단 CR 목록을 표시합니다.

   CR 차단이 있는 cgu-c 의 예

   apiVersion: ran.openshift.io/v1alpha1
   kind: ClusterGroupUpgrade
   metadata:
     name: cgu-c
     namespace: default
   spec:
     clusters:
     - spoke6
     enable: true
     managedPolicies:
     - policy1-common-cluster-version-policy
     - policy2-common-pao-sub-policy
     - policy3-common-ptp-sub-policy
     - policy4-common-sriov-sub-policy
     remediationStrategy:
       maxConcurrency: 1
       timeout: 240
   status:
     conditions:
     - message: The ClusterGroupUpgrade CR has upgrade policies that are still non compliant 1
       reason: UpgradeNotCompleted
       status: "False"
       type: Ready
     copiedPolicies:
     - cgu-c-policy1-common-cluster-version-policy
     - cgu-c-policy4-common-sriov-sub-policy
     managedPoliciesCompliantBeforeUpgrade:
     - policy2-common-pao-sub-policy
     - policy3-common-ptp-sub-policy
     managedPoliciesForUpgrade:
     - name: policy1-common-cluster-version-policy
       namespace: default
     - name: policy4-common-sriov-sub-policy
       namespace: default
     placementBindings:
     - cgu-c-policy1-common-cluster-version-policy
     - cgu-c-policy4-common-sriov-sub-policy
     placementRules:
     - cgu-c-policy1-common-cluster-version-policy
     - cgu-c-policy4-common-sriov-sub-policy
     remediationPlan:
     - - spoke6
     status:
       currentBatch: 1
       remediationPlanForBatch:
         spoke6: 0

   1

   cgu-c 업데이트에는 차단 CR이 없습니다.

프로세스

1. status.state.AtLatestKnown 필드를 Operator의 Subscription CR에 추가합니다.

   서브스크립션 CR의 예

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: cluster-logging
     namespace: openshift-logging
     annotations:
       ran.openshift.io/ztp-deploy-wave: "2"
   spec:
     channel: "stable"
     name: cluster-logging
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     installPlanApproval: Manual
   status:
     state: AtLatestKnown 1

   1

   status.state: AtLatestKnown 필드는 Operator 카탈로그에서 사용 가능한 최신 Operator 버전에 사용됩니다.

   참고

   레지스트리에서 새 버전의 Operator를 사용할 수 있으면 연결된 정책이 호환되지 않습니다.

2. ClusterGroupUpgrade CR이 있는 관리 클러스터에 변경된 서브스크립션 정책을 적용합니다.

프로세스

1. ClusterGroupUpgrade CR의 내용을 cgu-1.yaml 파일에 저장합니다.

   apiVersion: ran.openshift.io/v1alpha1
   kind: ClusterGroupUpgrade
   metadata:
     name: cgu-1
     namespace: default
   spec:
     managedPolicies: 1
       - policy1-common-cluster-version-policy
       - policy2-common-nto-sub-policy
       - policy3-common-ptp-sub-policy
       - policy4-common-sriov-sub-policy
     enable: false
     clusters: 2
     - spoke1
     - spoke2
     - spoke5
     - spoke6
     remediationStrategy:
       maxConcurrency: 2 3
       timeout: 240 4
     batchTimeoutAction: 5

   1

   적용할 정책의 이름입니다.

   2

   업데이트할 클러스터 목록입니다.

   3

   maxConcurrency 필드는 동시에 업데이트되는 클러스터 수를 나타냅니다.

   4

   업데이트 제한 시간(분)입니다.

   5

   일괄 처리가 시간 초과되는 경우 발생하는 작업을 제어합니다. 가능한 값은 abort 또는 continue 입니다. 지정되지 않은 경우 기본값은 계속됩니다.

2. 다음 명령을 실행하여 ClusterGroupUpgrade CR을 생성합니다.

   $ oc create -f cgu-1.yaml

   1. 다음 명령을 실행하여 Hub 클러스터에서 ClusterGroupUpgrade CR이 생성되었는지 확인합니다.

      $ oc get cgu --all-namespaces

      출력 예

      NAMESPACE   NAME  AGE  STATE      DETAILS
      default     cgu-1 8m55 NotEnabled Not Enabled

   2. 다음 명령을 실행하여 업데이트 상태를 확인합니다.

      $ oc get cgu -n default cgu-1 -ojsonpath='{.status}' | jq

      출력 예

      {
        "computedMaxConcurrency": 2,
        "conditions": [
          {
            "lastTransitionTime": "2022-02-25T15:34:07Z",
            "message": "Not enabled", 1
            "reason": "NotEnabled",
            "status": "False",
            "type": "Progressing"
          }
        ],
        "copiedPolicies": [
          "cgu-policy1-common-cluster-version-policy",
          "cgu-policy2-common-nto-sub-policy",
          "cgu-policy3-common-ptp-sub-policy",
          "cgu-policy4-common-sriov-sub-policy"
        ],
        "managedPoliciesContent": {
          "policy1-common-cluster-version-policy": "null",
          "policy2-common-nto-sub-policy": "[{\"kind\":\"Subscription\",\"name\":\"node-tuning-operator\",\"namespace\":\"openshift-cluster-node-tuning-operator\"}]",
          "policy3-common-ptp-sub-policy": "[{\"kind\":\"Subscription\",\"name\":\"ptp-operator-subscription\",\"namespace\":\"openshift-ptp\"}]",
          "policy4-common-sriov-sub-policy": "[{\"kind\":\"Subscription\",\"name\":\"sriov-network-operator-subscription\",\"namespace\":\"openshift-sriov-network-operator\"}]"
        },
        "managedPoliciesForUpgrade": [
          {
            "name": "policy1-common-cluster-version-policy",
            "namespace": "default"
          },
          {
            "name": "policy2-common-nto-sub-policy",
            "namespace": "default"
          },
          {
            "name": "policy3-common-ptp-sub-policy",
            "namespace": "default"
          },
          {
            "name": "policy4-common-sriov-sub-policy",
            "namespace": "default"
          }
        ],
        "managedPoliciesNs": {
          "policy1-common-cluster-version-policy": "default",
          "policy2-common-nto-sub-policy": "default",
          "policy3-common-ptp-sub-policy": "default",
          "policy4-common-sriov-sub-policy": "default"
        },
        "placementBindings": [
          "cgu-policy1-common-cluster-version-policy",
          "cgu-policy2-common-nto-sub-policy",
          "cgu-policy3-common-ptp-sub-policy",
          "cgu-policy4-common-sriov-sub-policy"
        ],
        "placementRules": [
          "cgu-policy1-common-cluster-version-policy",
          "cgu-policy2-common-nto-sub-policy",
          "cgu-policy3-common-ptp-sub-policy",
          "cgu-policy4-common-sriov-sub-policy"
        ],
        "precaching": {
          "spec": {}
        },
        "remediationPlan": [
          [
            "spoke1",
            "spoke2"
          ],
          [
            "spoke5",
            "spoke6"
          ]
        ],
        "status": {}
      }

      1

      ClusterGroupUpgrade CR의 spec.enable 필드는 false 로 설정됩니다.

   3. 다음 명령을 실행하여 정책의 상태를 확인합니다.

      $ oc get policies -A

      출력 예

      NAMESPACE   NAME                                                 REMEDIATION ACTION   COMPLIANCE STATE   AGE
      default     cgu-policy1-common-cluster-version-policy            enforce                                 17m 1
      default     cgu-policy2-common-nto-sub-policy                    enforce                                 17m
      default     cgu-policy3-common-ptp-sub-policy                    enforce                                 17m
      default     cgu-policy4-common-sriov-sub-policy                  enforce                                 17m
      default     policy1-common-cluster-version-policy                inform               NonCompliant       15h
      default     policy2-common-nto-sub-policy                        inform               NonCompliant       15h
      default     policy3-common-ptp-sub-policy                        inform               NonCompliant       18m
      default     policy4-common-sriov-sub-policy                      inform               NonCompliant       18m

      1

      클러스터에 현재 적용된 정책의 spec.remediationAction 필드는 적용 하도록 설정되어 있습니다. 업데이트 중에 ClusterGroupUpgrade CR의 알림 모드에서 관리되는 정책은 알림 모드로 유지됩니다.

3. 다음 명령을 실행하여 spec.enable 필드의 값을 true 로 변경합니다.

   $ oc --namespace=default patch clustergroupupgrade.ran.openshift.io/cgu-1 \
   --patch '{"spec":{"enable":true}}' --type=merge

검증

1. 다음 명령을 실행하여 업데이트 상태를 다시 확인합니다.

   $ oc get cgu -n default cgu-1 -ojsonpath='{.status}' | jq

   출력 예

   {
     "computedMaxConcurrency": 2,
     "conditions": [ 1
       {
         "lastTransitionTime": "2022-02-25T15:33:07Z",
         "message": "All selected clusters are valid",
         "reason": "ClusterSelectionCompleted",
         "status": "True",
         "type": "ClustersSelected",
         "lastTransitionTime": "2022-02-25T15:33:07Z",
         "message": "Completed validation",
         "reason": "ValidationCompleted",
         "status": "True",
         "type": "Validated",
         "lastTransitionTime": "2022-02-25T15:34:07Z",
         "message": "Remediating non-compliant policies",
         "reason": "InProgress",
         "status": "True",
         "type": "Progressing"
       }
     ],
     "copiedPolicies": [
       "cgu-policy1-common-cluster-version-policy",
       "cgu-policy2-common-nto-sub-policy",
       "cgu-policy3-common-ptp-sub-policy",
       "cgu-policy4-common-sriov-sub-policy"
     ],
     "managedPoliciesContent": {
       "policy1-common-cluster-version-policy": "null",
       "policy2-common-nto-sub-policy": "[{\"kind\":\"Subscription\",\"name\":\"node-tuning-operator\",\"namespace\":\"openshift-cluster-node-tuning-operator\"}]",
       "policy3-common-ptp-sub-policy": "[{\"kind\":\"Subscription\",\"name\":\"ptp-operator-subscription\",\"namespace\":\"openshift-ptp\"}]",
       "policy4-common-sriov-sub-policy": "[{\"kind\":\"Subscription\",\"name\":\"sriov-network-operator-subscription\",\"namespace\":\"openshift-sriov-network-operator\"}]"
     },
     "managedPoliciesForUpgrade": [
       {
         "name": "policy1-common-cluster-version-policy",
         "namespace": "default"
       },
       {
         "name": "policy2-common-nto-sub-policy",
         "namespace": "default"
       },
       {
         "name": "policy3-common-ptp-sub-policy",
         "namespace": "default"
       },
       {
         "name": "policy4-common-sriov-sub-policy",
         "namespace": "default"
       }
     ],
     "managedPoliciesNs": {
       "policy1-common-cluster-version-policy": "default",
       "policy2-common-nto-sub-policy": "default",
       "policy3-common-ptp-sub-policy": "default",
       "policy4-common-sriov-sub-policy": "default"
     },
     "placementBindings": [
       "cgu-policy1-common-cluster-version-policy",
       "cgu-policy2-common-nto-sub-policy",
       "cgu-policy3-common-ptp-sub-policy",
       "cgu-policy4-common-sriov-sub-policy"
     ],
     "placementRules": [
       "cgu-policy1-common-cluster-version-policy",
       "cgu-policy2-common-nto-sub-policy",
       "cgu-policy3-common-ptp-sub-policy",
       "cgu-policy4-common-sriov-sub-policy"
     ],
     "precaching": {
       "spec": {}
     },
     "remediationPlan": [
       [
         "spoke1",
         "spoke2"
       ],
       [
         "spoke5",
         "spoke6"
       ]
     ],
     "status": {
       "currentBatch": 1,
       "currentBatchStartedAt": "2022-02-25T15:54:16Z",
       "remediationPlanForBatch": {
         "spoke1": 0,
         "spoke2": 1
       },
       "startedAt": "2022-02-25T15:54:16Z"
     }
   }

   1

   현재 배치의 업데이트 진행 상황을 반영합니다. 이 명령을 다시 실행하여 진행 상황에 대한 업데이트된 정보를 수신합니다.

2. 정책에 Operator 서브스크립션이 포함된 경우 단일 노드 클러스터에서 직접 설치 진행 상황을 확인할 수 있습니다.

   1. 다음 명령을 실행하여 설치 진행 상황을 확인할 단일 노드 클러스터의 KUBECONFIG 파일을 내보냅니다.

      $ export KUBECONFIG=<cluster_kubeconfig_absolute_path>

   2. 단일 노드 클러스터에 있는 모든 서브스크립션을 확인하고 다음 명령을 실행하여 ClusterGroupUpgrade CR을 통해 설치하려는 정책에서 해당 서브스크립션을 찾습니다.

      $ oc get subs -A | grep -i <subscription_name>

      cluster-logging 정책의 출력 예

      NAMESPACE                              NAME                         PACKAGE                      SOURCE             CHANNEL
      openshift-logging                      cluster-logging              cluster-logging              redhat-operators   stable

3. 관리 정책 중 하나에 ClusterVersion CR이 포함된 경우 spoke 클러스터에 대해 다음 명령을 실행하여 현재 일괄 처리에서 플랫폼 업데이트 상태를 확인합니다.

   $ oc get clusterversion

   출력 예

   NAME      VERSION   AVAILABLE   PROGRESSING   SINCE   STATUS
   version   4.4.14.5     True        True          43s     Working towards 4.4.14.7: 71 of 735 done (9% complete)

4. 다음 명령을 실행하여 Operator 서브스크립션을 확인합니다.

   $ oc get subs -n <operator-namespace> <operator-subscription> -ojsonpath="{.status}"

5. 다음 명령을 실행하여 원하는 서브스크립션과 연결된 단일 노드 클러스터에 있는 설치 계획을 확인합니다.

   $ oc get installplan -n <subscription_namespace>

   cluster-logging Operator의 출력 예

   NAMESPACE                              NAME            CSV                                 APPROVAL   APPROVED
   openshift-logging                      install-6khtw   cluster-logging.5.3.3-4             Manual     true 1

   1

   설치 계획의 승인 필드가 Manual 로 설정되고 TALM에서 설치 계획을 승인한 후 승인 필드가 false 에서 true 로 변경됩니다.

   참고

   TALM이 서브스크립션이 포함된 정책을 수정하면 해당 서브스크립션에 연결된 모든 설치 계획을 자동으로 승인합니다. Operator를 최신 알려진 버전으로 가져오기 위해 여러 설치 계획이 필요한 경우 TALM은 여러 설치 계획을 승인하여 하나 이상의 중간 버전을 통해 최종 버전으로 업그레이드할 수 있습니다.

6. 다음 명령을 실행하여 ClusterGroupUpgrade 가 Succeeded 단계에 도달한 정책의 Operator의 클러스터 서비스 버전이 있는지 확인합니다.

   $ oc get csv -n <operator_namespace>

   OpenShift Logging Operator의 출력 예

   NAME                    DISPLAY                     VERSION   REPLACES   PHASE
   cluster-logging.5.4.2   Red Hat OpenShift Logging   5.4.2                Succeeded

프로세스

1. clustergroupupgrades-group-du.yaml 파일에서 backup 및 enable 필드를 true 로 설정하여 ClusterGroupUpgrade CR의 내용을 저장합니다.

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

2. 업데이트를 시작하려면 다음 명령을 실행하여 ClusterGroupUpgrade CR을 적용합니다.

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

프로세스

1. 다음 명령을 실행하여 이전에 생성한 ClusterGroupUpgrade CR(사용자 정의 리소스)을 삭제합니다.

   $ oc delete cgu/du-upgrade-4918 -n ztp-group-du-sno

2. 복구할 클러스터에 로그인합니다.

3. 다음 명령을 실행하여 플랫폼 OS 배포의 상태를 확인합니다.

   $ ostree admin status

   출력 예

   [root@lab-test-spoke2-node-0 core]# ostree admin status
   * rhcos c038a8f08458bbed83a77ece033ad3c55597e3f64edad66ea12fda18cbdceaf9.0
       Version: 49.84.202202230006-0
       Pinned: yes 1
       origin refspec: c038a8f08458bbed83a77ece033ad3c55597e3f64edad66ea12fda18cbdceaf9

   1

   현재 배포가 고정되어 있습니다. 플랫폼 OS 배포 롤백은 필요하지 않습니다.

   [root@lab-test-spoke2-node-0 core]# ostree admin status
   * rhcos f750ff26f2d5550930ccbe17af61af47daafc8018cd9944f2a3a6269af26b0fa.0
       Version: 410.84.202204050541-0
       origin refspec: f750ff26f2d5550930ccbe17af61af47daafc8018cd9944f2a3a6269af26b0fa
   rhcos ad8f159f9dc4ea7e773fd9604c9a16be0fe9b266ae800ac8470f63abc39b52ca.0 (rollback) 1
       Version: 410.84.202203290245-0
       Pinned: yes 2
       origin refspec: ad8f159f9dc4ea7e773fd9604c9a16be0fe9b266ae800ac8470f63abc39b52ca

   1

   이 플랫폼 OS 배포는 롤백용으로 표시됩니다.

   2

   이전 배포가 고정되어 롤백할 수 있습니다.

4. 플랫폼 OS 배포의 롤백을 트리거하려면 다음 명령을 실행합니다.

   $ rpm-ostree rollback -r

5. 복구의 첫 번째 단계는 컨테이너를 종료하고 백업 파티션에서 대상 디렉터리로 파일을 복원합니다. 복구를 시작하려면 다음 명령을 실행합니다.

   $ /var/recovery/upgrade-recovery.sh

6. 메시지가 표시되면 다음 명령을 실행하여 클러스터를 재부팅합니다.

   $ systemctl reboot

7. 재부팅 후 다음 명령을 실행하여 복구를 다시 시작합니다.

   $ /var/recovery/upgrade-recovery.sh  --resume

프로세스

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. 다음 명령을 실행하여 Hub 클러스터에 ClusterGroupUpgrade CR이 있는지 확인합니다.

   $ oc get cgu -A

   출력 예

   NAMESPACE          NAME              AGE   STATE        DETAILS
   ztp-group-du-sno   du-upgrade-4918   10s   InProgress   Precaching is required and not done 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 required and not done",
         "reason": "InProgress",
         "status": "False",
         "type": "PrecachingSucceeded"
       },
       {
         "lastTransitionTime": "2022-01-27T19:07:34Z",
         "message": "Pre-caching spec is valid and consistent",
         "reason": "PrecacheSpecIsWellFormed",
         "status": "True",
         "type": "PrecacheSpecValid"
       }
     ],
     "precaching": {
       "clusters": [
         "cnfdb1" 1
         "cnfdb2"
       ],
       "spec": {
         "platformImage": "image.example.io"},
       "status": {
         "cnfdb1": "Active"
         "cnfdb2": "Succeeded"}
       }
   }

   1

   식별된 클러스터 목록을 표시합니다.

3. spoke 클러스터에서 다음 명령을 실행하여 사전 캐싱 작업의 상태를 확인합니다.

   $ oc get jobs,pods -n openshift-talo-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": "PrecachingSucceeded" 1
       }

   1

   사전 캐시 작업이 수행됩니다.

1. spec.enable 필드가 false 로 설정된 ClusterGroupUpgrade CR을 생성합니다.
2. 상태가 업데이트될 때까지 기다린 후 문제 해결 질문을 진행합니다.
3. 모든 항목이 예상대로 표시되면 ClusterGroupUpgrade CR에서 spec.enable 필드를 true 로 설정합니다.

1. spoke 클러스터에서 다음 명령을 실행하여 사전 캐싱 상태를 확인합니다.

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