업그레이드
AWS에서 Red Hat OpenShift Service의 업그레이드 옵션 이해
초록
1장. AWS 클러스터에서 Red Hat OpenShift Service 업그레이드 링크 복사링크가 클립보드에 복사되었습니다!
1.1. AWS 클러스터의 Red Hat OpenShift Service 업그레이드 옵션 링크 복사링크가 클립보드에 복사되었습니다!
OpenShift에서 업그레이드는 업데이트된 소프트웨어가 포함된 새 구성 요소를 프로비저닝하고 이를 사용하여 오래된 소프트웨어가 있는 기존 구성 요소를 교체하는 것을 의미합니다.
예를 들어 클러스터의 업그레이드 부분을 제어하여 워크로드에 대한 업그레이드의 영향을 제어할 수 있습니다.
- 호스팅된 컨트롤 플레인만 업그레이드
- 그러면 호스팅된 컨트롤 플레인의 업그레이드가 시작됩니다. 작업자 노드에는 영향을 미치지 않습니다.
- 머신 풀의 노드 업그레이드
- AWS 머신 풀 업그레이드의 Red Hat OpenShift Service는 업그레이드 프로세스 중에 머신 풀의 각 노드를 완전히 대체하도록 설계되었습니다. 이는 인플레이스 업그레이드를 수행함으로써 추가적인 보안 및 안정성 이점을 제공합니다. 머신 풀의 노드를 업그레이드하면 지정된 머신 풀의 노드 롤링 교체가 시작되고 해당 머신 풀의 작업자 노드에 일시적으로 영향을 미칩니다. 여러 머신 풀을 동시에 업그레이드할 수도 있습니다.
호스트된 컨트롤 플레인을 머신 풀 업그레이드와 동시에 업그레이드할 수 없습니다. 먼저 호스팅된 컨트롤 플레인을 업그레이드한 다음 머신 풀을 업그레이드해야 합니다.
클러스터의 노드 간 호환성을 유지하기 위해 머신 풀의 노드는 호스팅된 컨트롤 플레인보다 최신 버전을 사용할 수 없습니다. 즉, 머신 풀을 동일한 버전으로 업그레이드하기 전에 호스팅 컨트롤 플레인을 지정된 버전으로 업그레이드해야 합니다.
각 머신 풀에 대해 --max-surge 및 --max-unavailable 값을 편집하여 머신 풀 업그레이드에 필요한 시간과 워크로드 업그레이드의 영향을 추가로 제어할 수 있습니다. 이러한 옵션은 머신 풀에서 동시에 업그레이드할 수 있는 노드 수와 업그레이드에서 초과 노드를 프로비저닝하거나 일부 기존 노드를 사용할 수 없게 하는지 또는 둘 다 사용할 수 없도록 하는지 여부를 제어합니다. 예를 들면 다음과 같습니다.
-
높은 워크로드 가용성에 우선순위를 지정하려면
--max-surge에 더 높은 값을 설정하고--max-unavailable을0으로 설정하여 기존 노드를 사용할 수 없게 하는 대신 초과 노드를 프로비저닝할 수 있습니다. -
인프라 비용을 낮추기 위해 일부 기존 노드를 사용할 수 없게 하고
--max-unavailable에 더 높은 값을 설정하고--max-surge를0으로 설정하여 초과 노드를 프로비저닝하지 않도록 할 수 있습니다. -
여러 노드를 동시에 업그레이드하여 업그레이드 속도를 우선시하려면 초과 노드를 프로비저닝하고
--max-surge및--max-unavailable둘 다에 적합한 값을 구성하여 기존 노드를 사용할 수 없도록 할 수 있습니다.
이러한 매개변수 및 사용법에 대한 자세한 내용은 rosa edit machinepool 에 대한 ROSA CLI 참조를 참조하십시오.
1.2. 라이프 사이클 정책 및 계획 링크 복사링크가 클립보드에 복사되었습니다!
업그레이드를 계획하려면 AWS 업데이트 라이프 사이클에서 Red Hat OpenShift Service 를 검토하십시오.
라이프 사이클 페이지에는 릴리스 정의, 지원 및 업그레이드 요구 사항, 설치 정책 정보 및 라이프 사이클 날짜가 포함되어 있습니다.
업그레이드는 수동으로 시작하거나 자동으로 예약됩니다. Red Hat 사이트 안정성 엔지니어(SRE)는 업그레이드 진행 상황을 모니터링하고 발생하는 모든 문제를 해결합니다.
컨트롤 플레인이 현재 다중 아키텍처가 활성화되어 있지 않은 경우 업그레이드 프로세스는 먼저 클러스터를 다중 아키텍처 이미지로 마이그레이션한 다음 버전 업그레이드를 적용합니다. 다중 아키텍처 클러스터는 x86 기반 및 Arm 기반 워크로드를 모두 실행할 수 있습니다. 2024년 7월 25일 이후에 생성된 클러스터는 기본적으로 다중 아키텍처가 활성화됩니다.
1.3. ROSA CLI를 사용하여 호스팅된 컨트롤 플레인 업그레이드 링크 복사링크가 클립보드에 복사되었습니다!
ROSA CLI를 사용하여 AWS 클러스터에서 Red Hat OpenShift Service의 호스팅된 컨트롤 플레인을 수동으로 업그레이드할 수 있습니다. 이 방법은 최신 버전을 즉시 또는 지정된 나중에 사용할 수 있는 경우 업그레이드에 대한 컨트롤 플레인을 예약합니다.
컨트롤 플레인은 두 개의 마이너 Y-stream 버전 내에서 머신 풀만 지원합니다. 예를 들어 버전 4.15.z를 사용하는 컨트롤 플레인이 있는 AWS 클러스터의 Red Hat OpenShift Service는 4.13.z 및 4.14.z 버전의 머신 풀을 지원하지만 컨트롤 플레인은 version 4.12.z를 사용하는 머신 풀을 지원하지 않습니다.
사전 요구 사항
- 최신 버전의 ROSA CLI를 설치하고 구성했습니다.
- 호스팅된 컨트롤 플레인 업그레이드와 동시에 머신 풀 업그레이드가 진행 중이거나 예약되지 않습니다.
프로세스
다음 명령을 실행하여 현재 클러스터 버전을 확인합니다.
rosa describe cluster --cluster=<cluster_name_or_id>
$ rosa describe cluster --cluster=<cluster_name_or_id>1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- &
lt;cluster_name_or_id>를 클러스터 이름 또는 클러스터 ID로 바꿉니다.
다음 명령을 실행하여 컨트롤 플레인을 업그레이드할 수 있는 버전을 나열합니다.
rosa list upgrade --cluster=<cluster_name_or_id>
$ rosa list upgrade --cluster=<cluster_name_or_id>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 명령은 권장 버전을 포함하여 사용 가능한 업데이트 목록을 반환합니다.
출력 예
VERSION NOTES 4.14.8 recommended 4.14.7 4.14.6
VERSION NOTES 4.14.8 recommended 4.14.7 4.14.6Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 클러스터의 호스팅 컨트롤 플레인을 업그레이드합니다.
rosa upgrade cluster -c <cluster_name_or_id> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>
$ rosa upgrade cluster -c <cluster_name_or_id> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 지정된 버전으로 즉시 업그레이드를 예약하려면 다음 명령을 실행합니다.
rosa upgrade cluster -c <cluster_name_or_id> --version <version_number>
$ rosa upgrade cluster -c <cluster_name_or_id> --version <version_number>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 호스팅된 컨트롤 플레인이 즉시 업그레이드되도록 예정되어 있습니다.
향후 지정된 버전으로의 업그레이드를 예약하려면 다음 명령을 실행합니다.
rosa upgrade cluster -c <cluster_name_or_id> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version=<version_number>
$ rosa upgrade cluster -c <cluster_name_or_id> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version=<version_number>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 호스트된 컨트롤 플레인은 UTC(Coordinated Universal Time)로 지정된 시간에 업그레이드될 예정입니다.
문제 해결
- 경우에 따라 예약된 업그레이드가 시작되지 않는 경우가 있습니다. 자세한 내용은 취소된 업그레이드 유지 관리를 참조하십시오.
1.4. ROSA CLI를 사용하여 머신 풀 업그레이드 링크 복사링크가 클립보드에 복사되었습니다!
ROSA CLI를 사용하여 HCP 클러스터로 ROSA에서 하나 이상의 머신 풀을 수동으로 업그레이드할 수 있습니다. 이 메서드는 최신 버전을 즉시 또는 지정된 나중에 사용할 수 있는 경우 업그레이드에 대해 지정된 머신 풀을 예약합니다.
컨트롤 플레인은 두 개의 마이너 Y-stream 버전 내에서 머신 풀만 지원합니다. 예를 들어 버전 4.15.z를 사용하는 컨트롤 플레인이 있는 HCP 클러스터가 있는 ROSA는 4.13.z 및 4.14.z 버전의 머신 풀을 지원하지만 컨트롤 플레인은 version 4.12.z를 사용하는 머신 풀을 지원하지 않습니다.
사전 요구 사항
- 최신 버전의 ROSA CLI를 설치하고 구성했습니다.
- 호스팅된 컨트롤 플레인에 대한 업그레이드가 클러스터에서 진행 중이거나 머신 풀 업그레이드와 동시에 발생하도록 예약되지 않습니다.
노드 드레이닝 시간 제한, max-unavailable 및 max-surge와 같은 머신 풀 구성은 업그레이드 타이밍 및 성공에 영향을 미칠 수 있습니다.
프로세스
다음 명령을 실행하여 현재 클러스터 버전을 확인합니다.
rosa describe cluster --cluster=<cluster_name_or_id>
$ rosa describe cluster --cluster=<cluster_name_or_id>1 Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- &
lt;cluster_name_or_id>를 클러스터 이름 또는 클러스터 ID로 바꿉니다.
출력 예
OpenShift Version: 4.14.0
OpenShift Version: 4.14.0Copy to Clipboard Copied! Toggle word wrap Toggle overflow 다음 명령을 실행하여 머신 풀을 업그레이드할 수 있는 버전을 나열합니다.
rosa list upgrade --cluster <cluster-name> --machinepool <machinepool_name>
$ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 명령은 권장 버전을 포함하여 사용 가능한 업데이트 목록을 반환합니다.
출력 예
VERSION NOTES 4.14.5 recommended 4.14.4 4.14.3
VERSION NOTES 4.14.5 recommended 4.14.4 4.14.3Copy to Clipboard Copied! Toggle word wrap Toggle overflow 중요머신 풀을 컨트롤 플레인보다 높은 버전으로 업그레이드하지 마십시오. 더 높은 버전으로 이동하려면 먼저 컨트롤 플레인을 해당 버전으로 업그레이드합니다.
다음 명령을 실행하여 업그레이드하려는 머신 풀의 업그레이드 동작을 확인합니다.
rosa describe machinepool --cluster=<cluster_name_or_id> <machinepool_name>
$ rosa describe machinepool --cluster=<cluster_name_or_id> <machinepool_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 출력 예
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 이 설정을 사용하면 머신 풀이 하나의 초과 노드(복제
복제본의 20%)를 프로비저닝하고 업그레이드할 때최대하나의 노드를 사용할 수 없는 노드(최대 20%의)를 가질 수 있습니다. 따라서 이 머신 풀은 복제본 수를 초과하는 하나의 새 노드를 프로비저닝하고 하나의 노드를 사용할 수 없는 상태로 교체하여 한 번에 두 개의 노드를 업그레이드할 수 있습니다. Pod 중단 예산이 있는 워크로드를 보호하기 위해 필요한 경우 노드 업그레이드가 최대 30분(복제본에서 사용 가능node-drain-grace-periodof 30분)까지 지연될 수 있습니다.다음 명령을 실행하여 머신 풀을 업그레이드합니다.
rosa upgrade machinepool -c <cluster_name> <machinepool_name> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>
$ rosa upgrade machinepool -c <cluster_name> <machinepool_name> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 업그레이드할 각 머신 풀에 대해 이 명령을 실행하여 여러 머신 풀을 동시에 업그레이드할 수 있습니다.
머신 풀의 즉각적인 업그레이드를 예약하려면 다음 명령을 실행합니다.
rosa upgrade machinepool -c <cluster_name> <machinepool_name> --version <version_number>
$ rosa upgrade machinepool -c <cluster_name> <machinepool_name> --version <version_number>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 머신 풀은 즉시 업그레이드를 위해 예약되며, 이 경우 지정된 머신 풀의 모든 노드 롤링 교체가 시작됩니다.
나중에 시작할 업그레이드를 예약하려면 다음 명령을 실행합니다.
rosa upgrade machinepool -c <cluster_name> <machinepool_name> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version <version_number>
$ rosa upgrade machinepool -c <cluster_name> <machinepool_name> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version <version_number>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 머신 풀은 UTC(Coordinated Universal Time)의 지정된 시간 및 날짜에 업그레이드를 시작하도록 예정되어 있습니다. 이렇게 하면 지정된 시간부터 지정된 머신 풀의 모든 노드를 롤링 대체할 수 있습니다.
Legal Notice
링크 복사링크가 클립보드에 복사되었습니다!
Copyright © 2025 Red Hat
OpenShift documentation is licensed under the Apache License 2.0 (https://www.apache.org/licenses/LICENSE-2.0).
Modified versions must remove all Red Hat trademarks.
Portions adapted from https://github.com/kubernetes-incubator/service-catalog/ with modifications by Red Hat.
Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.