15.4. GitOps ZTP를 사용하여 단일 노드 OpenShift 클러스터에 대한 이미지 기반 업그레이드 수행

프로세스

1. ImageBasedGroupUpgrade CR이 포함된 허브 클러스터에 YAML 파일을 만듭니다.

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors: 

   1

   
       - matchExpressions:
         - key: name
           operator: In
           values:
           - spoke1
           - spoke4
           - spoke6
     ibuSpec:
       seedImageRef: 

   2

   
         image: quay.io/seed/image:4.16.0-rc.1
         version: 4.16.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
       extraManifests: 

   3

   
         - name: example-extra-manifests
           namespace: openshift-lifecycle-agent
       oadpContent: 

   4

   
         - name: oadp-cm
           namespace: openshift-adp
     plan: 

   5

   
       - actions: ["Prep"]
         rolloutStrategy:
           maxConcurrency: 2
           timeout: 2400

   Copy to Clipboard Toggle word wrap

   1

   업그레이드할 클러스터.

   2

   대상 플랫폼 버전, 사용할 시드 이미지, 이미지에 액세스하는 데 필요한 비밀번호입니다.

   참고

   허브 클러스터에 ImageBasedGroupUpgrade 리소스와 동일한 네임스페이스에서 시드 이미지 풀 시크릿을 추가하면 해당 시크릿이 준비 단계의 매니페스트 목록에 추가됩니다. 비밀은 openshift-lifecycle-agent 네임스페이스의 각 스포크 클러스터에서 다시 생성됩니다.

   3

   선택 사항: 시드 이미지에 없는 추가 매니페스트를 대상 클러스터에 적용합니다. 사용자 정의 카탈로그 소스에 ConfigMap 오브젝트도 적용합니다.

   4

   OADP 백업 및 복원 CR이 포함된 ConfigMap 리소스 목록입니다.

   5

   업그레이드 계획 세부 정보.

2. 허브 클러스터에서 다음 명령을 실행하여 생성된 파일을 적용합니다.

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

3. 허브 클러스터에서 다음 명령을 실행하여 상태 업데이트를 모니터링합니다.

   $ oc get ibgu -o yaml

   Copy to Clipboard Toggle word wrap

   출력 예

   # ...
   status:
     clusters:
     - completedActions:
       - action: Prep
       name: spoke1
     - completedActions:
       - action: Prep
       name: spoke4
     - failedActions:
       - action: Prep
       name: spoke6
   # ...

   Copy to Clipboard Toggle word wrap

   이전 예제 계획의 출력은 준비 단계에서만 시작하며, 이전 단계의 결과에 따라 계획에 작업을 추가합니다. TALM은 업그레이드가 성공했는지 실패했는지를 표시하기 위해 클러스터에 레이블을 추가합니다. 예를 들어, lcm.openshift.io/ibgu-prep-failed 는 준비 단계에서 실패한 클러스터에 적용됩니다.

   실패를 조사한 후 업그레이드 계획에 AbortOnFailure 단계를 추가할 수 있습니다. lcm.openshift.io/ibgu-<action>-failed 로 라벨이 지정된 클러스터를 다시 유휴 단계로 이동합니다. 선택한 클러스터의 업그레이드와 관련된 모든 리소스가 삭제됩니다.

4. 선택 사항: 다음 명령을 실행하여 기존 ImageBasedGroupUpgrade CR에 AbortOnFailure 작업을 추가합니다.

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["AbortOnFailure"], "rolloutStrategy": {"maxConcurrency": 5, "timeout": 10}}}]'

   Copy to Clipboard Toggle word wrap

   1. 다음 명령을 실행하여 상태 업데이트를 계속 모니터링합니다.

      $ oc get ibgu -o yaml

      Copy to Clipboard Toggle word wrap

5. 다음 명령을 실행하여 기존 ImageBasedGroupUpgrade CR에 작업을 추가합니다.

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["Upgrade"], "rolloutStrategy": {"maxConcurrency": 2, "timeout": 30}}}]'

   Copy to Clipboard Toggle word wrap

6. 선택 사항: 다음 명령을 실행하여 기존 ImageBasedGroupUpgrade CR에 AbortOnFailure 작업을 추가합니다.

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["AbortOnFailure"], "rolloutStrategy": {"maxConcurrency": 5, "timeout": 10}}}]'

   Copy to Clipboard Toggle word wrap

   1. 다음 명령을 실행하여 상태 업데이트를 계속 모니터링합니다.

      $ oc get ibgu -o yaml

      Copy to Clipboard Toggle word wrap

7. 다음 명령을 실행하여 기존 ImageBasedGroupUpgrade CR에 작업을 추가합니다.

   $ oc patch ibgu <filename> --type=json -p \
   '[{"op": "add", "path": "/spec/plan/-", "value": {"actions": ["FinalizeUpgrade"], "rolloutStrategy": {"maxConcurrency": 10, "timeout": 3}}}]'

   Copy to Clipboard Toggle word wrap

프로세스

1. ImageBasedGroupUpgrade CR이 포함된 허브 클러스터에 YAML 파일을 만듭니다.

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors: 

   1

   
       - matchExpressions:
         - key: name
           operator: In
           values:
           - spoke1
           - spoke4
           - spoke6
     ibuSpec:
       seedImageRef: 

   2

   
         image: quay.io/seed/image:4.19.0-rc.1
         version: 4.19.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
       extraManifests: 

   3

   
         - name: example-extra-manifests
           namespace: openshift-lifecycle-agent
       oadpContent: 

   4

   
         - name: oadp-cm
           namespace: openshift-adp
     plan: 

   5

   
       - actions: ["Prep", "Upgrade", "FinalizeUpgrade"]
         rolloutStrategy:
           maxConcurrency: 200 

   6

   
           timeout: 2400 

   7

   Copy to Clipboard Toggle word wrap

   1

   업그레이드할 클러스터.

   2

   대상 플랫폼 버전, 사용할 시드 이미지, 이미지에 액세스하는 데 필요한 비밀번호입니다.

   참고

   허브 클러스터에 ImageBasedGroupUpgrade 리소스와 동일한 네임스페이스에서 시드 이미지 풀 시크릿을 추가하면 해당 시크릿이 준비 단계의 매니페스트 목록에 추가됩니다. 비밀은 openshift-lifecycle-agent 네임스페이스의 각 스포크 클러스터에서 다시 생성됩니다.

   3

   선택 사항: 시드 이미지에 없는 추가 매니페스트를 대상 클러스터에 적용합니다. 사용자 정의 카탈로그 소스에 ConfigMap 오브젝트도 적용합니다.

   4

   OADP 백업 및 복원 CR이 포함된 ConfigMap 리소스입니다.

   5

   업그레이드 계획 세부 정보.

   6

   일괄 처리로 업데이트할 클러스터 수입니다.

   7

   작업을 완료하는 데 걸리는 시간 제한(분)입니다.

2. 허브 클러스터에서 다음 명령을 실행하여 생성된 파일을 적용합니다.

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

프로세스

1. ImageBasedGroupUpgrade CR이 포함된 허브 클러스터에 별도의 YAML 파일을 만듭니다.

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors:
       - matchExpressions:
         - key: name
           operator: In
           values:
           - spoke4
     ibuSpec:
       seedImageRef:
         image: quay.io/seed/image:4.16.0-rc.1
         version: 4.16.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
       extraManifests:
         - name: example-extra-manifests
           namespace: openshift-lifecycle-agent
       oadpContent:
         - name: oadp-cm
           namespace: openshift-adp
     plan:
       - actions: ["Abort"]
         rolloutStrategy:
           maxConcurrency: 5
           timeout: 10

   Copy to Clipboard Toggle word wrap

   준비 단계를 완료한 모든 관리 클러스터는 유휴 단계로 돌아갑니다.

2. 허브 클러스터에서 다음 명령을 실행하여 생성된 파일을 적용합니다.

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

프로세스

1. ImageBasedGroupUpgrade CR이 포함된 허브 클러스터에 별도의 YAML 파일을 만듭니다.

   apiVersion: lcm.openshift.io/v1alpha1
   kind: ImageBasedGroupUpgrade
   metadata:
     name: <filename>
     namespace: default
   spec:
     clusterLabelSelectors:
       - matchExpressions:
         - key: name
           operator: In
           values:
           - spoke4
     ibuSpec:
       seedImageRef:
         image: quay.io/seed/image:4.19.0-rc.1
         version: 4.19.0-rc.1
         pullSecretRef:
           name: "<seed_pull_secret>"
       extraManifests:
         - name: example-extra-manifests
           namespace: openshift-lifecycle-agent
       oadpContent:
         - name: oadp-cm
           namespace: openshift-adp
     plan:
       - actions: ["Rollback", "FinalizeRollback"]
         rolloutStrategy:
           maxConcurrency: 200
           timeout: 2400

   Copy to Clipboard Toggle word wrap

2. 허브 클러스터에서 다음 명령을 실행하여 생성된 파일을 적용합니다.

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

   정의된 레이블과 일치하는 모든 관리 클러스터는 롤백 단계 로 이동한 다음 유휴 단계로 이동하여 롤백을 완료합니다.