4장. 클러스터 업데이트 문제 해결
4.1. 클러스터 업데이트에 대한 데이터 수집
업데이트 문제에 대한 Red Hat 지원에 문의할 때는 지원 팀이 실패한 클러스터 업데이트 문제를 해결하는 데 사용할 데이터를 제공하는 것이 중요합니다.
4.1.1. 지원 케이스에 대한 로그 데이터 수집
로그 데이터를 포함하여 클러스터에서 데이터를 수집하려면 oc adm must-gather
명령을 사용합니다. 클러스터에 대한 데이터 수집을 참조하십시오.
4.1.2. oc adm upgrade status를 사용하여 클러스터 업데이트 상태 수집 (기술 프리뷰)
클러스터를 업데이트할 때 업데이트 진행 방식을 이해하는 것이 유용합니다. oc adm upgrade
명령은 업데이트 상태에 대한 제한된 정보를 반환하는 반면 이 릴리스에서는 oc adm upgrade status
명령이 기술 프리뷰 기능으로 도입되었습니다. 이 명령은 oc adm upgrade
명령에서 상태 정보를 분리하고 컨트롤 플레인 및 작업자 노드 업데이트 상태를 포함하여 클러스터 업데이트에 대한 특정 정보를 제공합니다.
oc adm upgrade status
명령은 읽기 전용이며 클러스터의 상태를 변경하지 않습니다.
oc adm upgrade status
명령은 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. 따라서 프로덕션 환경에서 사용하는 것은 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.
Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.
oc adm upgrade status
명령은 버전 4.12에서 지원되는 최신 릴리스까지 클러스터에 사용할 수 있습니다.
클러스터가 기술 프리뷰 지원 클러스터일 필요는 없지만 OC_ENABLE_CMD_UPGRADE_STATUS
기술 프리뷰 환경 변수를 활성화해야 합니다. 그렇지 않으면 OpenShift CLI(oc
)가 명령을 인식하지 못하고 기능을 사용할 수 없습니다.
절차
다음 명령을 실행하여
OC_ENABLE_CMD_UPGRADE_STATUS
환경 변수를true
로 설정합니다.$ export OC_ENABLE_CMD_UPGRADE_STATUS=true
oc adm upgrade status
명령을 실행합니다.$ oc adm upgrade status
예 4.1. 성공적으로 진행 중인 업데이트 출력 예
= Control Plane = Assessment: Progressing Target Version: 4.14.1 (from 4.14.0) Completion: 97% Duration: 54m 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.14.0 +10m ip-10-0-30-217.us-east-2.compute.internal Outdated Pending 4.14.0 ? ip-10-0-92-180.us-east-2.compute.internal Outdated Pending 4.14.0 ? = Worker Upgrade = = Worker Pool = Worker Pool: worker Assessment: Progressing Completion: 0% Worker Status: 3 Total, 2 Available, 1 Progressing, 3 Outdated, 1 Draining, 0 Excluded, 0 Degraded Worker Pool Nodes NAME ASSESSMENT PHASE VERSION EST MESSAGE ip-10-0-4-159.us-east-2.compute.internal Progressing Draining 4.14.0 +10m ip-10-0-20-162.us-east-2.compute.internal Outdated Pending 4.14.0 ? ip-10-0-99-40.us-east-2.compute.internal Outdated Pending 4.14.0 ? = Worker Pool = Worker Pool: infra Assessment: Progressing Completion: 0% Worker Status: 1 Total, 0 Available, 1 Progressing, 1 Outdated, 1 Draining, 0 Excluded, 0 Degraded Worker Pool Node NAME ASSESSMENT PHASE VERSION EST MESSAGE ip-10-0-4-159-infra.us-east-2.compute.internal Progressing Draining 4.14.0 +10m = Update Health = SINCE LEVEL IMPACT MESSAGE 14m4s Info None Update is proceeding well
이 정보를 사용하면 업데이트를 진행하는 방법에 대한 정보에 입각한 결정을 내릴 수 있습니다.
4.1.3. ClusterVersion 내역 수집
CVO(Cluster Version Operator)는 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
)가 설치되어 있습니다.
절차
다음 명령을 입력하여 클러스터 업데이트 기록을 확인합니다.
$ oc describe clusterversions/version
출력 예
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>
추가 리소스