이 페이지에서는 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
를 실행하여 최신 버전을 가져옵니다.
클러스터 업그레이드에 대한 정보 가져오기
Trusted Cloud 콘솔 또는 gcloud CLI를 사용하여 클러스터 업그레이드에 관한 정보를 확인할 수 있습니다.
프로젝트 수준에서 업그레이드에 관한 정보 가져오기
프로젝트 전반의 클러스터 업그레이드에 관한 집계 정보를 확인하려면 업그레이드 대시보드를 사용하면 됩니다.
Trusted Cloud 콘솔에서 업그레이드 대시보드로 이동합니다.
이 대시보드에 포함된 탭에는 다음과 같은 업그레이드 관련 정보가 집계됩니다.
- 최근 컨트롤 플레인 및 노드 업그레이드 상태
- 업그레이드 관련 클러스터 알림 로그
- 업그레이드와 관련된 추천
- 특정 부 버전의 지원 종료 타임라인
- 각 출시 채널의 클러스터 수
클러스터 수준에서 업그레이드 정보 가져오기
콘솔
Trusted Cloud 콘솔에서 Kubernetes 클러스터 페이지로 이동합니다.
클러스터 세부정보 페이지를 볼 클러스터 이름을 선택합니다.
클러스터 세부정보 페이지에서 클러스터 업그레이드 섹션을 확인합니다.
gcloud
다음 명령어를 실행합니다.
gcloud container clusters get-upgrade-info CLUSTER_NAME
CLUSTER_NAME
을 클러스터 이름으로 바꿉니다.
Standard 클러스터 노드 풀의 업그레이드 정보 가져오기
표준 클러스터의 개별 노드 풀을 확인할 수 있습니다. 이 섹션은 GKE가 노드를 관리하는 Autopilot 클러스터에는 적용되지 않으므로 관리할 노드 풀이 없습니다.
콘솔
Trusted Cloud 콘솔에서 Kubernetes 클러스터 페이지로 이동합니다.
클러스터 이름을 클릭하여 세부정보를 확인합니다.
노드 탭을 클릭합니다.
노드 풀 섹션에서 업그레이드 정보를 가져올 노드 풀의 이름을 클릭합니다.
노드 풀 세부정보 페이지에서 업그레이드 섹션을 확인합니다.
gcloud
다음 명령어를 실행합니다.
gcloud container node-pools get-upgrade-info POOL_NAME
--cluster=CLUSTER_NAME
POOL_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
를 필터링하세요. - 업그레이드 대시보드 (미리보기):Trusted Cloud 콘솔의 업그레이드 상태 표로 이동합니다. 클러스터를 찾습니다. 상태 열에 업그레이드됨이라고 표시되면 최신 업데이트 열에서 업그레이드가 완료된 시간을 확인하세요.
- 클러스터 수준에서 업그레이드 정보 가져오기: gcloud CLI를 사용하여 최근 업그레이드를 포함한 클러스터의 업그레이드 기록을 확인합니다.
업그레이드에 예상되는 시간 확인하기
업그레이드에 걸리는 예상 시간을 알아보려면 클러스터 수준에서 업그레이드 정보 가져오기를 통해 이전 업그레이드의 기간을 확인하세요. 최근 예시는 업그레이드 기록을 참고하세요.
업그레이드 기간은 컨트롤 플레인 또는 노드 업그레이드 여부, 업그레이드 전략, 포드 중단 예산 (PDB), 활성 유지관리 정책 및 기타 요인에 따라 달라집니다.
클러스터의 마이너 버전이 지원 종료 시점에 도달하는 시점 확인하기
GKE는 지원 종료 날짜가 지난 부 버전을 계속 실행하는 클러스터를 자동으로 업그레이드합니다. 자세한 내용은 지원 종료 시점의 자동 업그레이드를 참고하세요.
클러스터의 부 버전이 지원 종료 시점에 도달하는 시점을 알아보려면(예: 유지보수 제외를 설정하거나 지원 중단된 API를 더 이상 사용할 수 없는 시점을 파악) 다음 리소스를 사용하세요.
- 출시 일정: 출시 채널의 예상 일정에서 클러스터의 마이너 버전 및 출시 채널에 해당하는 지원 종료 날짜를 확인합니다. 확장 채널에 없는 클러스터의 경우 표준 지원 종료 날짜를 참고하세요. 확장 채널에 있는 클러스터의 경우 연장 지원 종료 날짜를 참고하세요.
- 클러스터 알림: 클러스터에서 지원 종료 시점에 도달했거나 지원 종료가 임박한 부 버전을 실행하면 GKE에서 알림을 전송합니다. 이러한 알림을 보려면 Cloud Logging에서 클러스터 알림을 볼 때
UpgradeInfoEvent
를 필터링하세요. - 통계 및 권장사항: 클러스터에서 스탠더드 지원 종료 후 부 버전을 실행하면 GKE에서 알림을 보냅니다. 자세한 내용은 스탠더드 지원 종료 후 부 버전을 실행하는 클러스터 식별을 참고하세요.
- 클러스터 수준에서 업그레이드 정보 가져오기: 클러스터의 마이너 버전 지원 종료일을 확인합니다.
- 업그레이드 대시보드 (미리보기): 업그레이드 대시보드에는 특정 버전과 지원 종료일까지 남은 일수가 표시된 버전 지원 종료 섹션이 포함되어 있습니다.