Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

4장. 클러스터 업데이트 문제 해결

4.1. 클러스터 업데이트에 대한 데이터 수집
링크 복사

업데이트 문제로 Red Hat 지원팀에 문의할 경우, 실패한 클러스터 업데이트 문제를 해결하는 데 사용할 수 있는 데이터를 제공하는 것이 중요합니다.

4.1.1. 지원 사례에 대한 로그 데이터 수집
링크 복사

로그 데이터를 포함한 클러스터에서 데이터를 수집하려면 oc adm must-gather 명령을 사용합니다. 클러스터에 대한 데이터 수집을 참조하세요.

클러스터를 업데이트할 때 oc adm upgrade 명령은 업데이트 상태에 대한 제한된 정보를 반환합니다. oc adm upgrade status 명령을 사용하면 oc adm upgrade 명령에서 상태 정보를 분리하고 제어 평면 및 작업자 노드 업데이트 상태를 포함하여 클러스터 업데이트에 대한 특정 정보를 반환할 수 있습니다.

oc adm upgrade status 명령은 읽기 전용이며 클러스터의 어떤 상태도 변경하지 않습니다.

중요

oc adm upgrade status 명령은 Technology Preview 기능에만 해당됩니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

oc adm upgrade status 명령은 버전 4.12부터 최신 지원 릴리스까지의 클러스터에 사용할 수 있습니다.

참고

oc adm upgrade status 명령을 사용하려면 클러스터가 Technology Preview가 활성화된 클러스터일 필요는 없습니다.

프로세스

  1. 다음 명령을 실행하여 OC_ENABLE_CMD_UPGRADE_STATUS 환경 변수를 true 로 설정합니다. 

    $ export OC_ENABLE_CMD_UPGRADE_STATUS=true
    Copy to Clipboard Toggle word wrap

  2. oc adm upgrade status 명령을 실행합니다. 

    $ oc adm upgrade status
    Copy to Clipboard Toggle word wrap

    업데이트가 성공적으로 진행됨에 대한 예시 출력

    = Control Plane =
Assessment:      Progressing
Target Version:  4.17.1 (from 4.17.0)
Updating:        machine-config
Completion:      97% (32 operators updated, 1 updating, 0 waiting)
Duration:        54m (Est. Time Remaining: <10m)
Operator Status: 32 Healthy, 1 Unavailable

Control Plane Nodes
NAME                                        ASSESSMENT    PHASE      VERSION   EST    MESSAGE
ip-10-0-53-40.us-east-2.compute.internal    Progressing   Draining   4.17.0    +10m
ip-10-0-30-217.us-east-2.compute.internal   Outdated      Pending    4.17.0    ?
ip-10-0-92-180.us-east-2.compute.internal   Outdated      Pending    4.17.0    ?

= Worker Upgrade =

WORKER POOL   ASSESSMENT    COMPLETION   STATUS
worker        Progressing   0% (0/2)     1 Available, 1 Progressing, 1 Draining
infra         Progressing   50% (1/2)    1 Available, 1 Progressing, 1 Draining

Worker Pool Nodes: Worker
NAME                                       ASSESSMENT    PHASE      VERSION   EST    MESSAGE
ip-10-0-4-159.us-east-2.compute.internal   Progressing   Draining   4.17.0    +10m
ip-10-0-99-40.us-east-2.compute.internal   Outdated      Pending    4.17.0    ?

Worker Pool Nodes: infra
NAME                                             ASSESSMENT    PHASE      VERSION   EST    MESSAGE
ip-10-0-4-159-infra.us-east-2.compute.internal   Progressing   Draining   4.17.0    +10m
ip-10-0-20-162.us-east-2.compute.internal        Completed     Updated    4.17.1    -

= Update Health =
SINCE   LEVEL   IMPACT   MESSAGE
54m4s   Info    None     Update is proceeding well
    Copy to Clipboard Toggle word wrap

4.1.3. ClusterVersion 기록 수집
링크 복사

클러스터 버전 운영자(CVO)는 클러스터에 대한 업데이트를 기록하며 이를 ClusterVersion 기록이라고 합니다. 항목은 클러스터 동작의 변화와 잠재적 요인 간의 상관관계를 보여줄 수 있지만, 상관관계가 인과관계를 의미하는 것은 아닙니다.

참고

초기, 마이너 및 z-stream 버전 업데이트는 ClusterVersion 기록에 저장됩니다. 하지만 ClusterVersion 기록에는 크기 제한이 있습니다. 한도에 도달하면 이전 마이너 버전의 가장 오래된 z-stream 업데이트가 한도를 수용하도록 정리됩니다.

OpenShift Container Platform 웹 콘솔이나 OpenShift CLI( oc )를 사용하여 ClusterVersion 기록을 볼 수 있습니다.

4.1.3.1. OpenShift Container Platform 웹 콘솔에서 ClusterVersion 기록 수집
링크 복사

OpenShift Container Platform 웹 콘솔에서 ClusterVersion 기록을 볼 수 있습니다.

사전 요구 사항

  • cluster-admin 역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.
  • OpenShift Container Platform 웹 콘솔에 액세스할 수 있습니다.

절차

  • 웹 콘솔에서 Administration Cluster Settings을 클릭하고 Details 탭의 내용을 확인합니다.

4.1.3.2. OpenShift CLI( oc )를 사용하여 ClusterVersion 기록 수집
링크 복사

OpenShift CLI( oc )를 사용하여 ClusterVersion 기록을 볼 수 있습니다.

사전 요구 사항

  • cluster-admin 역할의 사용자로 클러스터에 액세스할 수 있어야 합니다.
  • OpenShift CLI(oc)가 설치되어 있습니다.

절차

  1. 다음 명령을 입력하여 클러스터 업데이트 기록을 확인하세요. 

    $ oc describe clusterversions/version
    Copy to Clipboard Toggle word wrap

    출력 예

      Desired:
    Channels:
      candidate-4.13
      candidate-4.14
      fast-4.13
      fast-4.14
      stable-4.13
    Image:    quay.io/openshift-release-dev/ocp-release@sha256:a148b19231e4634196717c3597001b7d0af91bf3a887c03c444f59d9582864f4
    URL:      https://access.redhat.com/errata/RHSA-2023:6130
    Version:  4.13.19
  History:
    Completion Time:    2023-11-07T20:26:04Z
    Image:              quay.io/openshift-release-dev/ocp-release@sha256:a148b19231e4634196717c3597001b7d0af91bf3a887c03c444f59d9582864f4
    Started Time:       2023-11-07T19:11:36Z
    State:              Completed
    Verified:           true
    Version:            4.13.19
    Completion Time:    2023-10-04T18:53:29Z
    Image:              quay.io/openshift-release-dev/ocp-release@sha256:eac141144d2ecd6cf27d24efe9209358ba516da22becc5f0abc199d25a9cfcec
    Started Time:       2023-10-04T17:26:31Z
    State:              Completed
    Verified:           true
    Version:            4.13.13
    Completion Time:    2023-09-26T14:21:43Z
    Image:              quay.io/openshift-release-dev/ocp-release@sha256:371328736411972e9640a9b24a07be0af16880863e1c1ab8b013f9984b4ef727
    Started Time:       2023-09-26T14:02:33Z
    State:              Completed
    Verified:           false
    Version:            4.13.12
  Observed Generation:  4
  Version Hash:         CMLl3sLq-EA=
Events:                 <none>
    Copy to Clipboard Toggle word wrap

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat