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

프로세스

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

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

   다음과 같습니다.

   <target_version>

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

   <seed_container_image>

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

   <seed_pull_secret>

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

   <initMonitorTimeoutSeconds>

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

   extraManifests

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

   oadpContent

   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를 생성합니다. 여기에는 시드 이미지를 가져오고 압축 해제하고 호스트 수준 명령을 실행하는 작업이 포함됩니다. 마지막으로 Lifecycle Agent는 대상 클러스터에서 필요한 모든 이미지를 사전 캐시합니다.