15장. 단일 노드 OpenShift 클러스터를 위한 이미지 기반 업그레이드

Lifecycle Agent는 Operator가 처음 배포될 때 ImageBasedUpgrade CR을 생성하여 상태를 Idle 로 설정합니다. 이는 기본 단계입니다. 지속적인 업그레이드가 없으며 클러스터는 준비 단계로 이동할 준비가 되었습니다.

그림 15.2. Idle 단계에서의 전환

View larger image

또한 다음 단계 중 하나를 수행하려면 유휴 단계로 이동합니다.

유휴 단계로 이동하면 수명 주기 에이전트가 리소스를 정리하여 클러스터가 다시 업그레이드될 준비가 됩니다.

그림 15.3. 유휴 단계로의 전환

View larger image

준비 단계의 경우 ImageBasedUpgrade CR에서 다음 업그레이드 세부 정보를 지정합니다.

그런 다음, 귀하가 지정한 내용에 따라 Lifecycle Agent는 현재 실행 중인 버전에 영향을 주지 않고 업그레이드를 준비합니다. 이 단계에서 라이프사이클 에이전트는 특정 조건을 충족하는지 확인하여 대상 클러스터가 업그레이드 단계로 진행할 준비가 되었는지 확인합니다. 운영자는 시드 이미지에 지정된 추가 컨테이너 이미지와 함께 시드 이미지를 대상 클러스터로 가져옵니다. Lifecycle Agent는 컨테이너 스토리지 디스크에 충분한 공간이 있는지 확인하고, 필요한 경우 Operator는 디스크 사용량이 지정된 임계값 아래로 떨어질 때까지 고정 해제된 이미지를 삭제합니다. 컨테이너 스토리지 디스크 정리를 구성하거나 비활성화하는 방법에 대한 자세한 내용은 "컨테이너 스토리지 디스크의 자동 이미지 정리 구성"을 참조하세요.

또한 OADP 운영자의 백업 및 복원 CR을 사용하여 백업 리소스를 준비합니다. 이러한 CR은 업그레이드 단계에서 클러스터를 재구성하고, RHACM에 클러스터를 등록하고, 애플리케이션 아티팩트를 복원하는 데 사용됩니다.

OADP Operator 외에도 Lifecycle Agent는 ostree 버전 관리 시스템을 사용하여 백업을 생성하는데, 이를 통해 업그레이드와 롤백 후에 클러스터를 완전히 재구성할 수 있습니다.

준비 단계가 완료되면 유휴 단계로 이동하여 업그레이드 프로세스를 취소할 수 있고, ImageBasedUpgrade CR에서 업그레이드 단계로 이동하여 업그레이드를 시작할 수 있습니다. 업그레이드를 취소하면 운영자가 정리 작업을 수행합니다.

그림 15.4. 준비 단계에서의 전환

View larger image

업그레이드 단계는 두 단계로 구성됩니다.

업그레이드가 완료되고 변경 사항에 만족하면 유휴 단계로 이동하여 업그레이드를 마무리할 수 있습니다.

그림 15.5. 업그레이드 단계에서 전환

View larger image

업그레이드를 취소하려면 업그레이드 단계의 피벗 이전 단계까지 취소할 수 있습니다. 업그레이드 후 문제가 발생하면 롤백 단계로 이동하여 수동 롤백을 수행할 수 있습니다.

롤백 단계는 실패 시 수동 또는 자동으로 시작될 수 있습니다. 롤백 단계에서 라이프사이클 에이전트는 원래 ostree stateroot 배포를 기본값으로 설정합니다. 그런 다음 노드는 이전 릴리스의 OpenShift Container Platform과 애플리케이션 구성으로 재부팅됩니다.

Lifecycle Agent는 업그레이드가 지정된 시간 제한 내에 완료되지 않으면 자동 롤백을 시작합니다. 자동 롤백에 대한 자세한 내용은 "Lifecycle Agent를 사용하여 롤백 단계로 이동" 또는 "Lifecycle Agent와 GitOps ZTP를 사용하여 롤백 단계로 이동" 섹션을 참조하세요.

그림 15.6. 롤백 단계에서 전환

View larger image

배포 방법에 따라 이미지 기반 업그레이드에는 다음과 같은 최소 소프트웨어 버전이 필요합니다.

Red Hat Advanced Cluster Management(RHACM)를 사용하는 경우 허브 클러스터가 다음 조건을 충족해야 합니다.

시드 이미지는 동일한 하드웨어와 유사한 구성을 갖춘 단일 노드 OpenShift 클러스터 세트를 대상으로 합니다. 즉, 시드 클러스터는 다음 항목에 대한 대상 클러스터의 구성과 일치해야 합니다.

다음 구성은 참여 클러스터에서 부분적으로만 일치해야 합니다.

시드 이미지에 포함할 내용에 대한 자세한 내용은 "시드 이미지 구성" 및 "RAN DU 프로필을 사용한 시드 이미지 구성"을 참조하세요.

OADP Operator를 사용하면 ConfigMap 객체에 래핑된 백업 및 복원 CR을 사용하여 대상 클러스터에서 애플리케이션을 백업하고 복원할 수 있습니다. 업그레이드 후 복원할 수 있도록 애플리케이션은 현재 및 대상 OpenShift Container Platform 버전에서 작동해야 합니다. 백업에는 처음 생성된 리소스가 포함되어야 합니다.

다음 리소스는 백업에서 제외해야 합니다.

단일 노드 OpenShift에는 두 가지 로컬 스토리지 구현이 있습니다.

이미지 기반 업그레이드의 경우, 지정된 대상 클러스터에서 하나의 Operator만 지원됩니다.

영구 볼륨 내용은 피벗 이후에 보존되고 사용됩니다. DataProtectionApplication CR을 구성할 때 이미지 기반 업그레이드에 대해 .spec.configuration.restic.enable 이 false 로 설정되어 있는지 확인해야 합니다. 이렇게 하면 컨테이너 스토리지 인터페이스 통합이 비활성화됩니다.

apiVersion: velero.io/v1
kind: Backup
metadata:
  name: acm-klusterlet
  namespace: openshift-adp
  annotations:
    lca.openshift.io/apply-label: rbac.authorization.k8s.io/v1/clusterroles/klusterlet,apps/v1/deployments/open-cluster-management-agent/klusterlet 
  labels:
    velero.io/storage-location: default
spec:
  includedNamespaces:
   - open-cluster-management-agent
  includedClusterScopedResources:
   - clusterroles
  includedNamespaceScopedResources:
   - deployments

apiVersion: velero.io/v1
kind: Backup
metadata:
  name: acm-klusterlet
  namespace: openshift-adp
  annotations:
    lca.openshift.io/apply-label: rbac.authorization.k8s.io/v1/clusterroles/klusterlet,apps/v1/deployments/open-cluster-management-agent/klusterlet 

  labels:
    velero.io/storage-location: default
spec:
  includedNamespaces:
   - open-cluster-management-agent
  includedClusterScopedResources:
   - clusterroles
  includedNamespaceScopedResources:
   - deployments

Lifecycle Agent는 추가 매니페스트를 사용하여 새 stateroot 배포로 재부팅한 후 애플리케이션 아티팩트를 복원하기 전에 대상 클러스터를 복원합니다.

다른 배포 방법에는 추가 매니페스트를 적용하는 다른 방법이 필요합니다.

대상 클러스터에서 사용자 정의 카탈로그 소스를 사용하는 경우 올바른 릴리스 버전을 가리키는 추가 매니페스트로 포함해야 합니다.