3.3. 제어 평면만 업데이트 수행
Kubernetes의 기본 설계로 인해 마이너 버전 간의 모든 OpenShift Container Platform 업데이트는 직렬화되어야 합니다. OpenShift Container Platform <4.y>에서 <4.y+1>로 업데이트한 다음, <4.y+2>로 업데이트해야 합니다. OpenShift Container Platform <4.y>에서 <4.y+2>로 직접 업데이트할 수 없습니다. 그러나 두 개의 짝수 마이너 버전 간에 업데이트를 수행하려는 관리자는 비제어 평면 호스트를 한 번만 재부팅하여 해당 작업을 수행할 수 있습니다.
이 업데이트는 이전에 EUS-to-EUS 업데이트로 알려져 있었으며, 현재는 제어 평면 전용 업데이트라고 합니다. 이러한 업데이트는 OpenShift Container Platform의 짝수 번째 마이너 버전 간에만 적용됩니다.
제어 평면만 업데이트를 시도할 때 고려해야 할 몇 가지 주의 사항이 있습니다.
-
Control Plane Only 업데이트는 모든 버전의 업데이트가
안정적인
채널에서 제공된 후에만 제공됩니다. - 홀수 번호의 마이너 버전으로 업데이트하는 동안 또는 업데이트한 후 다음 짝수 번호의 버전으로 업데이트하기 전에 문제가 발생하는 경우, 이러한 문제를 해결하려면 비제어 플레인 호스트가 계속 진행하기 전에 홀수 번호의 버전으로 업데이트를 완료해야 할 수 있습니다.
- 유지 관리에 걸리는 시간을 수용하기 위해 작업자 또는 사용자 지정 풀 노드를 업데이트하여 부분적인 업데이트를 수행할 수 있습니다.
- 머신 구성 풀의 일시 중지가 해제되고 업데이트가 완료될 때까지 OpenShift Container Platform의 <4.y+1> 및 <4.y+2>에 있는 일부 기능과 버그 수정은 사용할 수 없습니다.
-
모든 클러스터는 풀을 일시 정지하지 않고 기존 업데이트를 위해 EUS 채널을 사용하여 업데이트할 수 있지만, 제어 평면이 아닌
MachineConfigPools
개체가 있는 클러스터만 풀을 일시 정지하여 제어 평면 전용 업데이트를 수행할 수 있습니다.
3.3.1. 제어 평면만 업데이트 수행 링크 복사링크가 클립보드에 복사되었습니다!
다음 절차에서는 모든 비 마스터
머신 구성 풀을 일시 중지하고 OpenShift Container Platform <4.y>에서 <4.y+1>로, 그리고 <4.y+2>로 업데이트를 수행한 다음, 머신 구성 풀의 일시 중지를 해제합니다. 이 절차를 따르면 전체 업데이트 기간이 줄어들고 작업자 노드가 다시 시작되는 횟수도 줄어듭니다.
사전 요구 사항
- OpenShift Container Platform <4.y+1> 및 <4.y+2>의 릴리스 노트를 검토하십시오.
- 계층화된 제품과 Operator Lifecycle Manager(OLM) 운영자에 대한 릴리스 노트와 제품 수명 주기를 검토하세요. 일부 제품과 OLM 운영자의 경우 Control Plane Only 업데이트 전이나 업데이트 중에 업데이트가 필요할 수 있습니다.
- OpenShift Container Platform <4.y+1>에서 <4.y+2>로 업데이트하기 전에 더 이상 사용되지 않는 API 제거와 같은 버전별 필수 구성 요소를 잘 알고 있는지 확인하세요.
클러스터에서 in-tree vSphere 볼륨을 사용하는 경우 vSphere를 7.0u3L+ 또는 8.0u2+ 버전으로 업데이트합니다.
중요OpenShift Container Platform 업데이트를 시작하기 전에 vSphere를 7.0u3L+ 또는 8.0u2+로 업데이트하지 않으면 업데이트 후 클러스터에서 알려진 문제가 발생할 수 있습니다. 자세한 내용은 OpenShift 4.12에서 4.13 또는 4.13에서 4.14 vSphere CSI Storage 마이그레이션에 대한 알려진 문제를 참조하십시오.
3.3.1.1. 웹 콘솔을 사용하여 제어 평면만 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
사전 요구 사항
- 머신 구성 풀이 일시 중지 해제되었는지 확인하세요.
-
클러스터 관리자
권한이 있는 사용자로 웹 콘솔에 액세스할 수 있습니다.
프로세스
- 웹 콘솔을 사용하여 모든 Operator Lifecycle Manager(OLM) Operator를 업데이트하려는 업데이트 버전과 호환되는 버전으로 업데이트합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 "설치된 운영자 업데이트"에서 확인할 수 있습니다. "추가 리소스"를 참조하세요.
모든 머신 구성 풀에
Up to date
상태가 표시되고 머신 구성 풀에UPDATING
상태가 표시되지 않는지 확인합니다.모든 머신 구성 풀의 상태를 보려면 컴퓨팅
MachineConfigPools를 클릭하고 업데이트 상태 열의 내용을 검토하세요. 참고머신 구성 풀에
Updating
상태가 있는 경우 이 상태가Up to date
로 변경될 때까지 기다립니다. 이 과정은 몇 분 정도 걸릴 수 있습니다.채널을
eus-<4.y+2>
로 설정합니다.채널을 설정하려면 관리
클러스터 설정 채널을 클릭하세요. 현재 하이퍼링크된 채널을 클릭하면 채널을 편집할 수 있습니다. - 마스터 풀을 제외한 모든 워커 머신 풀을 일시 중지합니다. 이 작업은 Compute 페이지의 MachineConfigPools 탭에서 수행할 수 있습니다. 일시 중지하려는 머신 구성 풀 옆에 있는 세로 타원을 선택하고 업데이트 일시 중지를 클릭합니다.
- 버전 <4.y+1>로 업데이트하고 저장 단계까지 완료합니다. "웹 콘솔을 사용하여 클러스터 업데이트"에서 이러한 작업을 수행하는 방법에 대한 자세한 내용을 확인할 수 있습니다. "추가 리소스"를 참조하세요.
- 클러스터의 마지막 완료된 버전을 확인하여 <4.y+1> 업데이트가 완료되었는지 확인하세요. 세부 정보 탭의 클러스터 설정 페이지에서 이 정보를 확인할 수 있습니다.
- 필요한 경우 웹 콘솔의 관리자 관점을 사용하여 OLM 운영자를 업데이트하세요. 이러한 작업을 수행하는 방법에 대한 자세한 내용은 "설치된 운영자 업데이트"에서 확인할 수 있습니다. "추가 리소스"를 참조하세요.
- 버전 <4.y+2>로 업데이트하고 저장 단계까지 완료합니다. "웹 콘솔을 사용하여 클러스터 업데이트"에서 이러한 작업을 수행하는 방법에 대한 자세한 내용을 확인할 수 있습니다. "추가 리소스"를 참조하세요.
- 클러스터의 마지막 완료된 버전을 확인하여 <4.y+2> 업데이트가 완료되었는지 확인하세요. 세부 정보 탭의 클러스터 설정 페이지에서 이 정보를 확인할 수 있습니다.
이전에 일시 중지된 모든 머신 구성 풀의 일시 중지를 해제합니다. 이 작업은 Compute 페이지의 MachineConfigPools 탭에서 수행할 수 있습니다. 일시 중지를 해제하려는 머신 구성 풀 옆에 있는 세로 타원을 선택하고 '업데이트 일시 중지 해제'를 클릭합니다.
중요풀이 일시 중지되면 클러스터는 향후 마이너 버전으로 업그레이드할 수 없으며 일부 유지 관리 작업이 금지됩니다. 이로 인해 클러스터가 향후 저하될 위험이 있습니다.
이전에 일시 중지한 풀이 업데이트되었는지 확인하고 클러스터가 버전 <4.y+2>로 업데이트를 완료했는지 확인하세요.
Compute 페이지의 MachineConfigPools 탭에서 업데이트 상태가 최신 상태인지 확인하여 풀이 업데이트되었는지 확인할 수 있습니다.
중요Red Hat Enterprise Linux(RHEL) 컴퓨팅 머신이 포함된 클러스터를 업데이트하는 경우, 업데이트 프로세스 동안 해당 머신을 일시적으로 사용할 수 없게 됩니다. 클러스터가
NotReady
상태가 되면 각 RHEL 시스템에 대해 업그레이드 플레이 북을 실행하여 업데이트를 완료해야 합니다. 자세한 내용은 추가 리소스 섹션의 "RHEL 컴퓨팅 시스템을 포함하는 클러스터 업그레이드"를 참조하십시오.클러스터의 마지막 완료된 버전을 확인하여 클러스터가 업데이트를 완료했는지 확인할 수 있습니다. 세부 정보 탭의 클러스터 설정 페이지에서 이 정보를 확인할 수 있습니다.
3.3.1.2. CLI를 사용하여 제어 평면만 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
사전 요구 사항
- 머신 구성 풀이 일시 중지 해제되었는지 확인하세요.
-
클러스터 관리자
권한이 있는 사용자로 OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다. -
각 업데이트 전에 OpenShift CLI(
oc
)를 대상 버전으로 업데이트하세요.
이 사전 요구 사항을 건너뛰는 것이 좋습니다. 업데이트 전에 OpenShift CLI( oc
)가 대상 버전으로 업데이트되지 않으면 예기치 않은 문제가 발생할 수 있습니다.
프로세스
- 웹 콘솔을 사용하여 모든 Operator Lifecycle Manager(OLM) Operator를 업데이트하려는 업데이트 버전과 호환되는 버전으로 업데이트합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 "설치된 운영자 업데이트"에서 확인할 수 있습니다. "추가 리소스"를 참조하세요.
모든 머신 구성 풀이
UPDATED
상태를 표시하는지, 어떤 머신 구성 풀도UPDATING
상태를 표시하지 않는지 확인합니다. 모든 머신 구성 풀의 상태를 보려면 다음 명령을 실행하세요.oc get mcp
$ oc get mcp
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
NAME CONFIG UPDATED UPDATING master rendered-master-ecbb9582781c1091e1c9f19d50cf836c True False worker rendered-worker-00a3f0c68ae94e747193156b491553d5 True False
NAME CONFIG UPDATED UPDATING master rendered-master-ecbb9582781c1091e1c9f19d50cf836c True False worker rendered-worker-00a3f0c68ae94e747193156b491553d5 True False
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 현재 버전은 <4.y>이고, 업데이트하려는 버전은 <4.y+2>입니다. 다음 명령을 실행하여
eus-<4.y+2>
채널로 변경하세요.oc adm upgrade channel eus-<4.y+2>
$ oc adm upgrade channel eus-<4.y+2>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고eus-<4.y+2>가
사용 가능한 채널 중 하나가 아니라는 오류 메시지가 나타나면 Red Hat이 여전히 EUS 버전 업데이트를 제공하고 있음을 나타냅니다. 이러한 출시 과정은 일반적으로 GA 날짜로부터 45~90일이 소요됩니다.다음 명령을 실행하여 마스터 풀을 제외한 모든 작업자 머신 풀을 일시 중지합니다.
oc patch mcp/worker --type merge --patch '{"spec":{"paused":true}}'
$ oc patch mcp/worker --type merge --patch '{"spec":{"paused":true}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고마스터 풀을 일시 중지할 수 없습니다.
다음 명령을 실행하여 최신 버전으로 업데이트하세요.
oc adm upgrade --to-latest
$ oc adm upgrade --to-latest
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Updating to latest version <4.y+1.z>
Updating to latest version <4.y+1.z>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 클러스터 버전을 검토하여 업데이트가 완료되었는지 확인하세요.
oc adm upgrade
$ oc adm upgrade
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Cluster version is <4.y+1.z> ...
Cluster version is <4.y+1.z> ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 버전 <4.y+2>로 업데이트하세요.
oc adm upgrade --to-latest
$ oc adm upgrade --to-latest
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 <4.y+2> 업데이트가 완료되었는지 확인하려면 클러스터 버전을 검색하세요.
oc adm upgrade
$ oc adm upgrade
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Cluster version is <4.y+2.z> ...
Cluster version is <4.y+2.z> ...
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 작업자 노드를 <4.y+2>로 업데이트하려면 다음 명령을 실행하여 이전에 일시 중지된 모든 머신 구성 풀의 일시 중지를 해제하세요.
oc patch mcp/worker --type merge --patch '{"spec":{"paused":false}}'
$ oc patch mcp/worker --type merge --patch '{"spec":{"paused":false}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 중요풀의 일시 중지가 해제되지 않으면 클러스터는 향후 마이너 버전으로 업데이트할 수 없으며 일부 유지 관리 작업이 금지됩니다. 이로 인해 클러스터가 향후 저하될 위험이 있습니다.
다음 명령을 실행하여 이전에 일시 중지한 풀이 업데이트되었고 버전 <4.y+2>에 대한 업데이트가 완료되었는지 확인하세요.
oc get mcp
$ oc get mcp
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 중요Red Hat Enterprise Linux(RHEL) 컴퓨팅 머신이 포함된 클러스터를 업데이트하는 경우, 업데이트 프로세스 동안 해당 머신을 일시적으로 사용할 수 없게 됩니다. 클러스터가
NotReady
상태가 되면 각 RHEL 시스템에 대해 업그레이드 플레이 북을 실행하여 업데이트를 완료해야 합니다. 자세한 내용은 추가 리소스 섹션의 "RHEL 컴퓨팅 시스템을 포함하는 클러스터 업그레이드"를 참조하십시오.출력 예
NAME CONFIG UPDATED UPDATING master rendered-master-52da4d2760807cb2b96a3402179a9a4c True False worker rendered-worker-4756f60eccae96fb9dcb4c392c69d497 True False
NAME CONFIG UPDATED UPDATING master rendered-master-52da4d2760807cb2b96a3402179a9a4c True False worker rendered-worker-4756f60eccae96fb9dcb4c392c69d497 True False
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.3.1.3. Operator Lifecycle Manager를 통해 설치된 계층형 제품 및 운영자에 대한 Control Plane Only 업데이트 링크 복사링크가 클립보드에 복사되었습니다!
웹 콘솔과 CLI에 대해 언급된 제어 평면 전용 업데이트 단계 외에도 다음이 포함된 클러스터에 대해 제어 평면 전용 업데이트를 수행할 때 고려해야 할 추가 단계가 있습니다.
- 레이어드 제품
- OLM(Operator Lifecycle Manager)을 통해 설치된 운영자
레이어드 제품이란 무엇인가요?
계층형 상품은 여러 개의 기본 상품으로 구성된 상품을 말하며, 이 기본 상품들은 함께 사용하도록 설계되었으며, 개별 구독으로 나눌 수 없습니다. 계층화된 OpenShift Container Platform 제품의 예를 보려면 OpenShift의 계층화된 제공을 참조하세요.
OLM을 통해 설치된 계층화된 제품 클러스터와 운영자 클러스터에 대해 제어 평면 전용 업데이트를 수행할 때 다음을 완료해야 합니다.
- 이전에 Operator Lifecycle Manager(OLM)를 통해 설치한 모든 Operator를 대상 릴리스와 호환되는 버전으로 업데이트했습니다. Operator를 업데이트하면 클러스터 업데이트 중에 기본 OperatorHub 카탈로그가 현재 마이너 버전에서 다음 마이너 버전으로 전환될 때 유효한 업데이트 경로가 있는지 확인할 수 있습니다. 호환성을 확인하는 방법과 필요한 경우 설치된 Operator를 업데이트하는 방법에 대한 자세한 내용은 "추가 리소스" 섹션의 "설치된 Operator 업데이트"를 참조하세요.
- 현재 운영자 버전과 의도된 운영자 버전 간의 클러스터 버전 호환성을 확인하세요. Red Hat OpenShift Container Platform Operator Update Information Checker를 사용하면 OLM 운영자가 어떤 버전과 호환되는지 확인할 수 있습니다.
예를 들어, 'OpenShift Data Foundation'에 대해 <4.y>에서 <4.y+2>로 제어 평면 전용 업데이트를 수행하는 단계는 다음과 같습니다. 이 작업은 CLI나 웹 콘솔을 통해 수행할 수 있습니다. 원하는 인터페이스를 통해 클러스터를 업데이트하는 방법에 대한 자세한 내용은 "추가 리소스"의 " 웹 콘솔을 사용한 제어 평면 전용 업데이트 " 및 "CLI를 사용한 제어 평면 전용 업데이트"를 참조하세요.
워크플로 예시
- 작업자 머신 풀을 일시 중지합니다.
-
OpenShift <4.y>
OpenShift <4.y+1> 업데이트. -
ODF <4.y>
ODF <4.y+1>로 업데이트합니다. -
OpenShift <4.y+1>
OpenShift <4.y+2>로 업데이트합니다. - ODF <4.y+2>로 업데이트합니다.
- 작업자 머신 풀의 일시 중지를 해제합니다.
ODF <4.y+2>에 대한 업데이트는 작업자 머신 풀의 일시 중지가 해제되기 전이나 후에 발생할 수 있습니다.