업그레이드


Red Hat OpenShift Service on AWS 4

AWS에서 Red Hat OpenShift Service의 업그레이드 옵션 이해

Red Hat OpenShift Documentation Team

초록

이 문서에서는 AWS(ROSA) 클러스터에서 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-unavailable0 으로 설정하여 기존 노드를 사용할 수 없게 하는 대신 초과 노드를 프로비저닝할 수 있습니다.
  • 인프라 비용을 낮추기 위해 일부 기존 노드를 사용할 수 없게 하고 --max-unavailable 에 더 높은 값을 설정하고 --max-surge0 으로 설정하여 초과 노드를 프로비저닝하지 않도록 할 수 있습니다.
  • 여러 노드를 동시에 업그레이드하여 업그레이드 속도를 우선시하려면 초과 노드를 프로비저닝하고 --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를 설치하고 구성했습니다.
  • 호스팅된 컨트롤 플레인 업그레이드와 동시에 머신 풀 업그레이드가 진행 중이거나 예약되지 않습니다.

프로세스

  1. 다음 명령을 실행하여 현재 클러스터 버전을 확인합니다.

    $ rosa describe cluster --cluster=<cluster_name_or_id> 
    1
    Copy to Clipboard Toggle word wrap
    1
    & lt;cluster_name_or_id >를 클러스터 이름 또는 클러스터 ID로 바꿉니다.
  2. 다음 명령을 실행하여 컨트롤 플레인을 업그레이드할 수 있는 버전을 나열합니다.

    $ rosa list upgrade --cluster=<cluster_name_or_id>
    Copy to Clipboard Toggle word wrap

    명령은 권장 버전을 포함하여 사용 가능한 업데이트 목록을 반환합니다.

    출력 예

    VERSION  NOTES
    4.14.8   recommended
    4.14.7
    4.14.6
    Copy to Clipboard Toggle word wrap

  3. 다음 명령을 실행하여 클러스터의 호스팅 컨트롤 플레인을 업그레이드합니다.

    $ rosa upgrade cluster -c <cluster_name_or_id> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>
    Copy to Clipboard Toggle word wrap
    • 지정된 버전으로 즉시 업그레이드를 예약하려면 다음 명령을 실행합니다.

      $ rosa upgrade cluster -c <cluster_name_or_id> --version <version_number>
      Copy to Clipboard Toggle word wrap

      호스팅된 컨트롤 플레인이 즉시 업그레이드되도록 예정되어 있습니다.

    • 향후 지정된 버전으로의 업그레이드를 예약하려면 다음 명령을 실행합니다.

      $ rosa upgrade cluster -c <cluster_name_or_id> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version=<version_number>
      Copy to Clipboard Toggle word wrap

      호스트된 컨트롤 플레인은 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와 같은 머신 풀 구성은 업그레이드 타이밍 및 성공에 영향을 미칠 수 있습니다.

프로세스

  1. 다음 명령을 실행하여 현재 클러스터 버전을 확인합니다.

    $ rosa describe cluster --cluster=<cluster_name_or_id> 
    1
    Copy to Clipboard Toggle word wrap
    1
    & lt;cluster_name_or_id >를 클러스터 이름 또는 클러스터 ID로 바꿉니다.

    출력 예

    OpenShift Version:     4.14.0
    Copy to Clipboard Toggle word wrap

  2. 다음 명령을 실행하여 머신 풀을 업그레이드할 수 있는 버전을 나열합니다.

    $ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool_name>
    Copy to Clipboard Toggle word wrap

    명령은 권장 버전을 포함하여 사용 가능한 업데이트 목록을 반환합니다.

    출력 예

    VERSION  NOTES
    4.14.5   recommended
    4.14.4
    4.14.3
    Copy to Clipboard Toggle word wrap

    중요

    머신 풀을 컨트롤 플레인보다 높은 버전으로 업그레이드하지 마십시오. 더 높은 버전으로 이동하려면 먼저 컨트롤 플레인을 해당 버전으로 업그레이드합니다.

  3. 다음 명령을 실행하여 업그레이드하려는 머신 풀의 업그레이드 동작을 확인합니다.

    $ rosa describe machinepool --cluster=<cluster_name_or_id> <machinepool_name>
    Copy to Clipboard Toggle word wrap

    출력 예

    Replicas: 5
    Node drain grace period:   30 minutes
    
    Management upgrade:
    - Type: Replace
    - Max surge: 20%
    - Max unavailable: 20%
    Copy to Clipboard Toggle word wrap

    이 설정을 사용하면 머신 풀이 하나의 초과 노드(복제 복제본의 20%)를 프로비저닝하고 업그레이드할 때최대 하나의 노드를 사용할 수 없는 노드(최대 20%의 복제본에서 사용 가능 )를 가질 수 있습니다. 따라서 이 머신 풀은 복제본 수를 초과하는 하나의 새 노드를 프로비저닝하고 하나의 노드를 사용할 수 없는 상태로 교체하여 한 번에 두 개의 노드를 업그레이드할 수 있습니다. Pod 중단 예산이 있는 워크로드를 보호하기 위해 필요한 경우 노드 업그레이드가 최대 30분(node-drain-grace-period of 30분)까지 지연될 수 있습니다.

  4. 다음 명령을 실행하여 머신 풀을 업그레이드합니다.

    $ rosa upgrade machinepool -c <cluster_name> <machinepool_name> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>
    Copy to Clipboard Toggle word wrap

    업그레이드할 각 머신 풀에 대해 이 명령을 실행하여 여러 머신 풀을 동시에 업그레이드할 수 있습니다.

    • 머신 풀의 즉각적인 업그레이드를 예약하려면 다음 명령을 실행합니다.

      $ rosa upgrade machinepool -c <cluster_name> <machinepool_name> --version <version_number>
      Copy to Clipboard Toggle word wrap

      머신 풀은 즉시 업그레이드를 위해 예약되며, 이 경우 지정된 머신 풀의 모든 노드 롤링 교체가 시작됩니다.

    • 나중에 시작할 업그레이드를 예약하려면 다음 명령을 실행합니다.

      $ rosa upgrade machinepool -c <cluster_name> <machinepool_name> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version <version_number>
      Copy to Clipboard Toggle word wrap

      머신 풀은 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.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat