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

프로세스

1. ImageBasedUpgrade CR이 패치되었는지 확인합니다.

   apiVersion: lca.openshift.io/v1
   kind: ImageBasedUpgrade
   metadata:
     name: upgrade
   spec:
     stage: Idle
     seedImageRef:
       version: 4.15.2 1
       image: <seed_container_image> 2
       pullSecretRef: <seed_pull_secret> 3
     autoRollbackOnFailure: {}
   #    initMonitorTimeoutSeconds: 1800 4
     extraManifests: 5
     - name: example-extra-manifests-cm
       namespace: openshift-lifecycle-agent
     - name: example-catalogsources-cm
       namespace: openshift-lifecycle-agent
     oadpContent: 6
     - name: oadp-cm-example
       namespace: openshift-adp

   1

   대상 플랫폼 버전. 값은 시드 이미지 버전과 일치해야 합니다.

   2

   대상 클러스터에서 시드 이미지를 가져올 수 있는 리포지토리입니다.

   3

   이미지가 프라이빗 레지스트리에 있는 경우 컨테이너 이미지를 가져오는 인증 정보가 있는 보안에 대한 참조입니다.

   4

   선택 사항: 첫 번째 재부팅 후 업그레이드가 완료되지 않으면 롤백할 시간(초)입니다. 정의되지 않거나 0 으로 설정하면 1800 초(30분)의 기본값이 사용됩니다.

   5

   선택 사항: 업그레이드 후 유지할 사용자 정의 카탈로그 소스와 시드 이미지에 포함되지 않은 대상 클러스터에 적용할 추가 매니페스트가 포함된 ConfigMap 리소스 목록입니다.

   6

   OADP Backup 및 Restore CR이 포함된 ConfigMap 리소스 목록입니다.

2. Prep 단계를 시작하려면 다음 명령을 실행하여 ImageBasedUpgrade CR의 stage 필드 값을 Prep 로 변경합니다.

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Prep"}}' --type=merge -n openshift-lifecycle-agent

   OADP 리소스 및 추가 매니페스트에 ConfigMap 오브젝트를 제공하는 경우 Lifecycle Agent는 Prep 단계에서 지정된 ConfigMap 오브젝트를 검증합니다. 다음 문제가 발생할 수 있습니다.

   • Lifecycle Agent가 추가Manifests 매개변수와 관련된 문제를 감지하면 유효성 검사 경고 또는 오류입니다.
   • 라이프사이클 에이전트가 oadpContent 매개변수와 관련된 문제를 감지하면 유효성 검사 오류가 발생합니다.

   검증 경고는 업그레이드 단계를 차단하지 않지만 업그레이드를 진행하는 것이 안전한지 결정해야 합니다. 이러한 경고(예: 누락된 CRD, 네임스페이스 또는 예행 실행 실패)는 경고에 대한 세부 정보를 사용하여 ImageBasedUpgrade CR의 Prep stage 및 annotation 필드에 대한 status.conditions 를 업데이트합니다.

   검증 경고 예

   # ...
   metadata:
   annotations:
     extra-manifest.lca.openshift.io/validation-warning: '...'
   # ...

   그러나 MachineConfig 또는 Operator 매니페스트를 추가 매니페스트에 추가하는 것과 같은 검증 오류로 인해 Prep 단계가 실패하고 Upgrade 단계를 차단합니다.

   검증을 통과하면 클러스터에서 새 ostree stateroot를 생성합니다. 여기에는 시드 이미지를 가져오고 압축 해제하고 호스트 수준 명령을 실행하는 작업이 포함됩니다. 마지막으로 대상 클러스터에서 필요한 모든 이미지가 미리 캐시됩니다.

프로세스

1. 업그레이드 단계로 이동하려면 다음 명령을 실행하여 ImageBased Upgrade CR에서 stage 필드의 값을 Upgrade로 변경합니다.

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Upgrade"}}' --type=merge

2. 다음 명령을 실행하여 ImageBasedUpgrade CR의 상태를 확인합니다.

   $ oc get ibu -o yaml

   출력 예

   status:
     conditions:
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: In progress
       observedGeneration: 5
       reason: InProgress
       status: "False"
       type: Idle
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed
       observedGeneration: 5
       reason: Completed
       status: "False"
       type: PrepInProgress
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed successfully
       observedGeneration: 5
       reason: Completed
       status: "True"
       type: PrepCompleted
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: |-
         Waiting for system to stabilize: one or more health checks failed
           - one or more ClusterOperators not yet ready: authentication
           - one or more MachineConfigPools not yet ready: master
           - one or more ClusterServiceVersions not yet ready: sriov-fec.v2.8.0
       observedGeneration: 1
       reason: InProgress
       status: "True"
       type: UpgradeInProgress
     observedGeneration: 1
     rollbackAvailabilityExpiration: "2024-05-19T14:01:52Z"
     validNextStages:
     - Rollback

   OADP Operator는 OADP Backup 및 Restore CR에 지정된 데이터 백업을 생성하고 대상 클러스터가 재부팅됩니다.

3. 다음 명령을 실행하여 CR의 상태를 모니터링합니다.

   $ oc get ibu -o yaml

4. 업그레이드에 만족하는 경우 다음 명령을 실행하여 ImageBasedUpgrade CR의 stage 필드 값을 Idle 에 패치하여 변경 사항을 완료합니다.

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Idle"}}' --type=merge

   중요

   업그레이드 후 Idle 단계로 이동한 후에는 변경 사항을 롤백할 수 없습니다.

   Lifecycle Agent는 업그레이드 프로세스 중에 생성된 모든 리소스를 삭제합니다.

5. 업그레이드 후 OADP Operator 및 해당 구성 파일을 제거할 수 있습니다. 자세한 내용은 "클러스터에서 Operator 삭제"를 참조하십시오.

검증

1. 다음 명령을 실행하여 ImageBasedUpgrade CR의 상태를 확인합니다.

   $ oc get ibu -o yaml

   출력 예

   status:
     conditions:
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: In progress
       observedGeneration: 5
       reason: InProgress
       status: "False"
       type: Idle
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed
       observedGeneration: 5
       reason: Completed
       status: "False"
       type: PrepInProgress
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Prep completed successfully
       observedGeneration: 5
       reason: Completed
       status: "True"
       type: PrepCompleted
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Upgrade completed
       observedGeneration: 1
       reason: Completed
       status: "False"
       type: UpgradeInProgress
     - lastTransitionTime: "2024-01-01T09:00:00Z"
       message: Upgrade completed
       observedGeneration: 1
       reason: Completed
       status: "True"
       type: UpgradeCompleted
     observedGeneration: 1
     rollbackAvailabilityExpiration: "2024-01-01T09:00:00Z"
     validNextStages:
     - Idle
     - Rollback

2. 다음 명령을 실행하여 클러스터 복원 상태를 확인합니다.

   $ oc get restores -n openshift-adp -o custom-columns=NAME:.metadata.name,Status:.status.phase,Reason:.status.failureReason

   출력 예

   NAME             Status      Reason
   acm-klusterlet   Completed   <none> 1
   apache-app       Completed   <none>
   localvolume      Completed   <none>

   1

   acm-klusterlet 은 RHACM 환경에만 적용됩니다.

프로세스

1. 롤백 단계로 이동하려면 다음 명령을 실행하여 stage 필드의 값을 ImageBasedUpgrade CR의 롤백 에 패치합니다.

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Rollback"}}' --type=merge

   Lifecycle Agent는 이전에 설치한 OpenShift Container Platform 버전으로 클러스터를 재부팅하고 애플리케이션을 복원합니다.

2. 변경 사항에 만족하는 경우 다음 명령을 실행하여 ImageBasedUpgrade CR의 stage 필드 값을 Idle 에 패치하여 롤백을 완료합니다.

   $ oc patch imagebasedupgrades.lca.openshift.io upgrade -p='{"spec": {"stage": "Idle"}}' --type=merge -n openshift-lifecycle-agent

   주의

   롤백 후 Idle 단계로 이동하는 경우 Lifecycle Agent는 업그레이드 실패 문제를 해결하는 데 사용할 수 있는 리소스를 정리합니다.