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 백업 및 복원 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는 준비 단계에서 지정된 ConfigMap 객체의 유효성을 검사합니다. 다음과 같은 문제가 발생할 수 있습니다.

   • Lifecycle Agent가 extraManifests 매개변수에 문제가 있는 경우 유효성 검사 경고 또는 오류가 발생합니다.
   • Lifecycle Agent가 oadpContent 매개변수에 문제가 있는 경우 검증 오류가 발생합니다.

   유효성 검사 경고는 업그레이드 단계를 차단하지 않지만 업그레이드를 진행하는 것이 안전한지 여부를 결정해야 합니다. 이러한 경고(CRD 누락, 네임스페이스 또는 드라이런 실패 등)는 ImageBasedUpgrade CR의 준비 단계 및 주석 필드에 대한 status.conditions 를 경고에 대한 세부 정보로 업데이트합니다.

   예제 유효성 검사 경고

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

   그러나 MachineConfig 또는 Operator 매니페스트를 추가 매니페스트에 추가하는 등의 유효성 검사 오류가 발생하면 준비 단계가 실패하고 업그레이드 단계가 차단됩니다.

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