이 페이지에서는 Google Kubernetes Engine (GKE) 클러스터의 업그레이드에 관한 정보를 가져오는 방법을 설명합니다. GKE는 시간이 지남에 따라 모든 클러스터를 자동으로 업그레이드합니다. GKE가 클러스터를 업그레이드할 때는 Kubernetes 제어 영역과 워커 노드의 버전을 별도의 작업으로 업데이트합니다.
GKE는 클러스터 업그레이드에 관한 정보를 집계하여 클러스터 상태를 더 잘 이해할 수 있도록 지원합니다. 클러스터에 대해 다음 정보를 가져올 수 있습니다.
- 자동 업그레이드 타겟: GKE가 클러스터에 타겟팅하는 새 버전을 찾습니다. 클러스터의 기존 버전 및 제약 조건에 따라 패치 또는 새 마이너 버전일 수 있습니다. 자동 업그레이드 대상이 없는 경우 클러스터가 이미 최신 업그레이드 대상을 사용 중이거나 GKE에서 기술적 또는 비즈니스적 이유로 자동 업그레이드 대상을 할당하지 않은 것입니다. GKE 출시 노트 버전 업데이트(예: 2024-R33 참고)에서 클러스터의 부 버전을 기반으로 일반 자동 업그레이드 대상을 검색할 수도 있습니다.
- 자동 업그레이드 상태: GKE 클러스터에는 클러스터 업그레이드 상태가 있습니다. 이 상태를 사용하여 현재 업그레이드에 관해 자세히 알아보고, 유지보수 제외 또는 업그레이드를 방해하는 이유와 같은 요인을 비롯하여 GKE에서 클러스터를 자동으로 업그레이드할 시기를 선택할 때 고려하는 제약 조건을 알아보세요. 자세한 내용은 클러스터 자동 업그레이드 상태를 참고하세요.
- 자동 업그레이드 기록: GKE는 클러스터의 최근 자동 제어 영역 업그레이드 및 자동 노드 업그레이드에 대한 스냅샷을 제공합니다. 최근 자동 제어 영역 및 노드 업그레이드의 경우 초기 버전, 대상 버전, 업그레이드 성공 여부, 실패 여부, 취소 여부를 확인할 수 있습니다.
- 지원 종료일: GKE는 부 버전을 최대 24개월 동안 지원합니다. 자세한 내용은 GKE 부 버전 수명 주기를 참고하세요. 현재 모든 마이너 버전의 지원 종료일은 출시 채널의 예상 일정을 참고하세요.
시작하기 전에
시작하기 전에 다음 태스크를 수행했는지 확인합니다.
- Google Kubernetes Engine API를 사용 설정합니다. Google Kubernetes Engine API 사용 설정
- 이 태스크에 Google Cloud CLI를 사용하려면 gcloud CLI를 설치한 후 초기화하세요. 이전에 gcloud CLI를 설치한 경우
gcloud components update를 실행하여 최신 버전을 가져옵니다.
클러스터 업그레이드 정보 가져오기
Google Cloud 콘솔 또는 gcloud CLI를 사용하여 클러스터 업그레이드에 대한 정보를 가져올 수 있습니다.
클러스터 수준에서 업그레이드 정보 가져오기
콘솔
Google Cloud 콘솔에서 Kubernetes 클러스터 페이지로 이동합니다.
클러스터 세부정보 페이지를 볼 클러스터 이름을 선택합니다.
클러스터 세부정보 페이지에서 클러스터 업그레이드 섹션을 참고합니다.
gcloud
다음 명령어를 실행합니다.
gcloud beta container clusters get-upgrade-info CLUSTER_NAME
CLUSTER_NAME을 클러스터 이름으로 바꿉니다.
표준 클러스터 노드 풀의 업그레이드 정보 가져오기
gcloud CLI를 사용하여 Standard 클러스터의 개별 노드 풀을 확인할 수 있습니다. 이 섹션은 GKE가 노드를 관리하므로 관리할 노드 풀이 없는 Autopilot 클러스터에는 적용되지 않습니다.
다음 명령어를 실행합니다.
gcloud beta container node-pools get-upgrade-info POOL_NAME
--cluster CLUSTER_NAME
POOL_NAME을 노드 풀의 이름으로 바꿉니다.
클러스터 자동 업그레이드 상태
클러스터의 자동 업그레이드 상태는 다음과 같습니다.
ACTIVE: 활성 업그레이드 상태입니다.UNKNOWN: 업그레이드 상태를 알 수 없습니다.MINOR_UPGRADE_PAUSED: 부 버전 업그레이드가 일시중지됩니다.UPGRADE_PAUSED: 모든 자동 업그레이드가 일시중지됩니다.
다음은 GKE에서 클러스터의 자동 업그레이드를 일시중지하는 데 발생할 수 있는 이유입니다.
AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED: 지정되지 않은 이유입니다.MAINTENANCE_WINDOW: 유지보수 기간으로 인해 클러스터 업그레이드가 방지됩니다.MAINTENANCE_EXCLUSION_: 이 접두사가 있는 일시중지 이유는 유지보수 제외로 인해 클러스터 업그레이드가 방지되고 있음을 나타냅니다. 접미사는 유지보수 제외의 범위를 나타냅니다(예:MAINTENANCE_EXCLUSION_NO_UPGRADES).CLUSTER_DISRUPTION_BUDGET: 클러스터 생성 또는 업그레이드와 같은 특정 작업 후에는 클러스터와 애플리케이션의 안정성과 가용성을 보호하기 위해 클러스터에 쿨다운 기간이 필요합니다.CLUSTER_DISRUPTION_BUDGET_MINOR_UPGRADE: 클러스터가 마이너 버전 업그레이드의 클러스터 서비스 중단 예산 범위를 벗어납니다.SYSTEM_CONFIG: 기술적 또는 비즈니스적인 이유로 자동 업그레이드가 일시적으로 일시중지되었습니다. 이 상태에서는 필요한 경우가 아니라면 수동 업그레이드를 수행하지 않는 것이 좋습니다.