클러스터 업그레이드 가시성 확보

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 페이지에서는 Google Kubernetes Engine (GKE) 클러스터의 업그레이드에 관한 정보를 가져오는 방법을 설명합니다. GKE는 시간이 지남에 따라 모든 클러스터를 자동으로 업그레이드합니다. GKE에서 클러스터를 업그레이드하면 GKE는 Kubernetes 컨트롤 플레인과 워커 노드의 버전을 별도의 작업으로 업데이트합니다.

GKE는 클러스터 업그레이드에 관한 정보를 집계하여 클러스터 상태를 더 잘 이해할 수 있도록 지원합니다. 클러스터에 대한 다음 정보를 가져올 수 있습니다.

• 자동 업그레이드 대상: GKE에서 클러스터에 타겟팅하는 새 버전을 찾습니다. 클러스터의 기존 버전 및 제약 조건에 따라 패치 또는 새 마이너 버전일 수 있습니다. 자동 업그레이드 대상이 없는 경우 클러스터가 이미 최신 업그레이드 대상을 사용 중이거나 GKE에서 기술적 또는 비즈니스적 이유로 자동 업그레이드 대상을 할당하지 않은 것입니다. GKE 출시 노트 버전 업데이트(예: 2024-R33 노트)에서 클러스터의 마이너 버전을 기반으로 일반 자동 업그레이드 대상을 검색할 수도 있습니다.
• 자동 업그레이드 상태: GKE 클러스터에는 클러스터 업그레이드 상태가 있습니다. 이 상태를 사용하여 현재 업그레이드에 관해 자세히 알아보고, 유지보수 제외 또는 업그레이드를 방해하는 이유와 같은 요소를 포함하여 클러스터를 자동으로 업그레이드할 시기를 선택할 때 GKE에서 고려하는 제약 조건을 알아보세요. 자세한 내용은 클러스터 자동 업그레이드 상태를 참고하세요.

• 업그레이드 기록: GKE는 자동 업그레이드와 수동 업그레이드를 모두 포함하여 클러스터의 최근 컨트롤 플레인 업그레이드 및 노드 업그레이드에 대한 스냅샷을 제공합니다. 최근 컨트롤 플레인 및 노드 업그레이드의 경우 다음과 같은 세부정보를 확인할 수 있습니다.

  • 버전: 초기 버전 및 대상 버전입니다.
  • 상태: 업그레이드가 아직 실행 중인지, 성공했는지, 실패했는지, 취소되었는지 여부입니다.
  • 시간: 시작 시간 및 종료 시간입니다.
  • 시작 유형: 업그레이드가 자동으로 트리거되었는지 또는 수동으로 트리거되었는지 여부입니다.

• 지원 종료일: GKE는 최대 24개월 동안 부 버전을 지원합니다. 자세한 내용은 GKE 마이너 버전 수명 주기를 참고하세요. 현재 모든 마이너 버전의 지원 종료일은 출시 채널의 예상 일정을 참고하세요.

• 클러스터 이벤트: GKE는 업그레이드 시작 또는 완료, 새 버전 사용 가능 여부, 보안 게시판, 지원 종료일과 같은 특정 이벤트에 대해 클러스터 알림을 Cloud Logging으로 전송합니다. GKE에서 Cloud Logging을 사용하여 이러한 이벤트를 자동으로 표시하는 것 외에도 이러한 알림을 Pub/Sub로 라우트할 수도 있습니다. 자세한 내용은 클러스터 알림을 참고하세요.

시작하기 전에

시작하기 전에 다음 태스크를 수행했는지 확인합니다.

• Google Kubernetes Engine API를 사용 설정합니다.
Google Kubernetes Engine API 사용 설정
• 이 태스크에 Google Cloud CLI를 사용하려면 gcloud CLI를 설치한 후 초기화하세요. 이전에 gcloud CLI를 설치한 경우 gcloud components update를 실행하여 최신 버전을 가져옵니다.

클러스터 업그레이드에 대한 정보 가져오기

Google Cloud 콘솔 또는 gcloud CLI를 사용하여 클러스터 업그레이드에 관한 정보를 가져올 수 있습니다.

프로젝트 수준에서 업그레이드에 대한 정보 가져오기

프로젝트 전반의 클러스터 업그레이드에 관한 집계된 정보를 확인하려면 업그레이드 대시보드를 사용하세요.

Google Cloud 콘솔에서 업그레이드 대시보드로 이동합니다.

업그레이드로 이동

이 대시보드의 탭에는 다음과 같은 업그레이드와 관련된 정보가 집계됩니다.

• 최근 컨트롤 플레인 및 노드 업그레이드 상태
• 업그레이드 관련 클러스터 알림 로그
• 업그레이드와 관련된 추천
• 특정 마이너 버전의 지원 종료 타임라인
• 각 출시 채널의 클러스터 수

클러스터 수준에서 업그레이드 정보 가져오기

gcloud container clusters get-upgrade-info CLUSTER_NAME

Standard 클러스터 노드 풀의 업그레이드 정보 가져오기

표준 클러스터의 개별 노드 풀을 확인할 수 있습니다. GKE가 노드를 관리하므로 관리할 노드 풀이 없는 Autopilot 클러스터에는 이 섹션이 적용되지 않습니다.

gcloud container node-pools get-upgrade-info POOL_NAME
    --cluster=CLUSTER_NAME

클러스터 자동 업그레이드 상태

클러스터의 자동 업그레이드 상태는 다음과 같습니다.

• ACTIVE: 활성 업그레이드 상태입니다.
• UNKNOWN: 업그레이드 상태를 알 수 없습니다.
• MINOR_UPGRADE_PAUSED: 마이너 버전 업그레이드가 일시중지됩니다.
• UPGRADE_PAUSED: 모든 자동 업그레이드가 일시중지됩니다.

다음은 GKE에서 클러스터의 자동 업그레이드를 일시중지하는 잠재적인 이유입니다.

• MAINTENANCE_WINDOW: 유지보수 기간으로 인해 클러스터 업그레이드가 방해받습니다.
• MAINTENANCE_EXCLUSION_: 이 접두사가 있는 일시중지된 이유는 유지보수 제외로 인해 클러스터 업그레이드가 방지되고 있음을 나타냅니다. 접미사는 유지보수 제외 범위를 나타냅니다(예: MAINTENANCE_EXCLUSION_NO_UPGRADES).
• CLUSTER_DISRUPTION_BUDGET: 클러스터 생성 또는 업그레이드와 같은 특정 작업 후 클러스터 및 애플리케이션의 안정성과 가용성을 보호하기 위해 클러스터에 쿨다운 기간이 필요합니다.
• CLUSTER_DISRUPTION_BUDGET_MINOR_UPGRADE: 클러스터가 마이너 버전 업그레이드의 클러스터 중단 예산 범위를 벗어납니다.
• SYSTEM_CONFIG: 기술 또는 비즈니스와 관련된 이유로 자동 업그레이드가 일시중지되었습니다. 이 상태에서는 필요한 경우가 아니라면 수동 업그레이드를 수행하지 않는 것이 좋습니다.
• AUTO_UPGRADE_PAUSED_REASON_UNSPECIFIED: 지정되지 않은 이유입니다.

클러스터 업그레이드의 일반적인 시나리오에 관한 정보 찾기

클러스터 업그레이드를 관리할 때 발생할 수 있는 일반적인 시나리오에 관한 정보를 확인합니다.

클러스터의 다음 업그레이드 시기를 확인합니다.

새 버전으로의 업그레이드를 계획하고 검증할 수 있도록 클러스터의 다음 업그레이드가 언제 예정되어 있는지 알아보려면 다음 리소스를 사용하세요.

• 출시 일정: 출시 채널의 예상 일정에서 클러스터의 부 버전 및 출시 채널에 해당하는 예상 자동 업그레이드 날짜를 찾습니다.
• 클러스터 수준에서 업그레이드 정보 가져오기: 클러스터의 자동 업그레이드 타겟을 찾습니다.
• 클러스터 알림: GKE는 채널에서 새 버전을 사용할 수 있게 되면 알림을 전송합니다. 새 버전이 출시되면 채널에 따라 시점이 달라지지만 GKE는 이 버전을 채널의 자동 업그레이드 대상으로 지정합니다. 이러한 알림을 보려면 Cloud Logging에서 클러스터 알림을 볼 때 UpgradeAvailableEvent를 필터링합니다.
• 출시 노트: 출시 노트를 참고하여 GKE가 채널에서 새 부 버전을 자동 업그레이드 대상으로 설정하는 시점을 알아보세요.

클러스터의 다음 업그레이드를 차단하는 요소 찾기

업그레이드 차단 원인을 파악하여 차단을 해제하려면 클러스터의 자동 업그레이드 상태를 확인하세요. 자동 업그레이드가 일시중지된 경우 이유를 확인하세요. 다음 방법 중 하나를 사용하세요.

• 프로젝트 수준에서 업그레이드 정보를 가져옵니다(미리보기). 업그레이드 탭을 클릭하면 업그레이드 상태 표가 표시됩니다. 표에서 클러스터를 찾아 클러스터의 자동 업그레이드 열을 확인합니다.
• 클러스터 수준에서 업그레이드 정보 가져오기를 사용하여 클러스터의 자동 업그레이드 상태를 확인합니다.

클러스터 업그레이드 완료 시점 확인

워크로드가 예상대로 작동하는지 확인할 수 있도록 클러스터의 제어 영역 및 노드 업그레이드가 완료되는 시점을 알아보려면 다음 리소스를 사용하세요.

• 클러스터 알림: GKE에서 클러스터 업그레이드 작업을 완료하면 알림이 전송됩니다. 이러한 알림을 보려면 Cloud Logging에서 클러스터 알림을 볼 때 UpgradeInfoEvent를 필터링하세요.
• 업그레이드 대시보드 (미리보기):Google Cloud 콘솔의 업그레이드 상태 표로 이동합니다. 클러스터를 찾습니다. 상태 열에 업그레이드됨이라고 표시되면 최종 업데이트 열에서 업그레이드가 완료된 시점을 확인하세요.
• 클러스터 수준에서 업그레이드 정보 가져오기: gcloud CLI를 사용하여 최근 업그레이드가 포함된 클러스터의 업그레이드 기록을 찾습니다.

업그레이드에 걸리는 예상 시간 확인하기

업그레이드에 걸리는 예상 시간을 알아보려면 클러스터 수준에서 업그레이드 정보를 가져와 이전 업그레이드의 시간을 확인하면 됩니다. 최근 업그레이드 내역의 예를 확인하세요.

업그레이드 기간은 컨트롤 플레인 또는 노드가 업그레이드되는지 여부, 업그레이드 전략, 팟 중단 예산 (PDB), 활성 유지보수 정책, 기타 요인에 따라 다릅니다.

클러스터의 마이너 버전이 지원 종료 시점에 도달하는 시점 확인

GKE는 지원 종료 날짜가 지났는데도 여전히 마이너 버전을 실행 중인 클러스터를 자동으로 업그레이드합니다. 자세한 내용은 지원 종료 시 자동 업그레이드를 참고하세요.

클러스터의 부 버전이 지원 종료되는 시점을 알아보려면(예: 유지보수 제외를 설정하거나 지원 중단된 API를 더 이상 사용할 수 없게 되는 시점을 파악하려면) 다음 리소스를 사용하세요.

• 출시 일정: 출시 채널의 예상 일정에서 클러스터의 마이너 버전 및 출시 채널에 해당하는 지원 종료일을 찾습니다. 확장 채널에 속하지 않는 클러스터의 경우 표준 지원 종료 날짜를 참고하세요. 연장 채널의 클러스터의 경우 연장 지원 종료 날짜를 참고하세요.
• 클러스터 알림: GKE는 지원 종료 시점 또는 그 직전에 클러스터가 마이너 버전을 실행할 때 알림을 전송합니다. 이러한 알림을 보려면 Cloud Logging에서 클러스터 알림을 볼 때 UpgradeInfoEvent를 필터링합니다.
• 통계 및 권장사항: 클러스터에서 스탠더드 지원 종료 후 마이너 버전을 실행하는 경우 GKE에서 이를 알려줍니다. 자세한 내용은 표준 지원 종료 후 마이너 버전을 실행하는 클러스터 식별을 참고하세요.
• 클러스터 수준에서 업그레이드 정보 가져오기: 클러스터의 부 버전 지원 종료일을 찾습니다.
• 업그레이드 대시보드 (미리보기): 업그레이드 대시보드에는 특정 버전과 지원 종료까지 남은 일 수가 포함된 버전 지원 종료 섹션이 있습니다.

다음 단계

• GKE 출시 일정
• GKE 출시 노트
• 클러스터 알림