출시 채널 사용

Autopilot Standard

플랫폼 관리자는 클러스터의 특정 출시 채널을 선택하여 GKE가 기능 가용성과 안정성 간에 선택한 균형 있는 버전으로 클러스터를 자동 업그레이드하도록 할 수 있습니다. 출시 채널에 대한 자세한 내용은 출시 채널 정보를 참조하세요.

GKE는 모든 Autopilot 클러스터를 출시 채널에 등록하고 기본적으로 표준 클러스터를 출시 채널에 등록합니다. 모든 클러스터 모드에서 특정 출시 채널을 선택할 수 있습니다. 표준 클러스터를 사용하면 출시 채널에 클러스터를 등록하지 않도록 선택할 수 있습니다.

이 페이지에서는 출시 채널과 관련된 다음 작업을 수행하는 방법을 설명합니다.

클러스터를 특정 출시 채널에 등록합니다.
클러스터의 출시 채널을 찾습니다.
출시 채널의 기본 및 사용 가능한 버전을 봅니다.
클러스터의 출시 채널을 변경합니다.
출시 채널에서 클러스터를 등록 해제합니다.

시작하기 전에

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

Google Kubernetes Engine API를 사용 설정합니다.

Google Kubernetes Engine API 사용 설정

이 태스크에 Google Cloud CLI를 사용하려면 gcloud CLI를 설치한 후 초기화합니다. 이전에 gcloud CLI를 설치한 경우 gcloud components update를 실행하여 최신 버전을 가져옵니다.
참고: 기존 gcloud CLI 설치의 경우 compute/region 및 compute/zone 속성을 설정해야 합니다. 기본 위치를 설정하면 gcloud CLI에서 One of [--zone, --region] must be supplied: Please specify location과 같은 오류를 방지할 수 있습니다.

출시 채널에 클러스터 등록

이 섹션에서는 새 클러스터 또는 이전에 출시 채널을 사용하지 않은 기존 클러스터에 특정 출시 채널을 선택하는 방법을 보여줍니다. 이미 출시 채널에 등록된 기존 클러스터의 출시 채널을 변경할 수도 있습니다.

특정 출시 채널에 새 클러스터 등록

모든 클러스터는 기본적으로 일반 출시 채널에 등록됩니다. 클러스터를 만들 때 클러스터의 특정 출시 채널을 선택하거나 클러스터가 생성된 후 출시 채널을 변경할 수 있습니다. Autopilot 클러스터는 출시 채널에 등록되어야 합니다. 표준 클러스터를 출시 채널에 등록하거나 등록 해제할 수 있습니다.

Google Cloud 콘솔이나 gcloud CLI를 사용하여 특정 출시 채널에 새 클러스터를 만들고 등록할 수 있습니다.

콘솔

클러스터 모드에 따라 다음 단계를 수행하여 클러스터를 만듭니다.

Autopilot 클러스터:
1. Autopilot 클러스터 만들기 페이지의 탐색 창에서 고급 설정을 클릭합니다.
  
  Autopilot 클러스터 만들기
2. 출시 채널 드롭다운 목록에서 클러스터를 등록할 출시 채널을 선택하거나 일반 채널 기본값을 그대로 둡니다.
Standard 클러스터:
1. Standard 클러스터 만들기 페이지의 클러스터 기본사항 섹션에서 출시 채널 하위 섹션으로 이동합니다.
  
  Kubernetes 클러스터 만들기
2. 출시 채널 드롭다운 목록에서 클러스터를 등록할 출시 채널을 선택하거나 일반 채널 기본값을 그대로 둡니다.
참고: 노드 자동 업그레이드 및 노드 자동 복구는 기본적으로 사용 설정됩니다. 출시 채널을 구독한 클러스터에서 노드 자동 업그레이드를 중지할 수 없지만 유지보수 기간 및 유지보수 제외를 사용하여 자동 업그레이드의 기간과 범위를 제어할 수 있습니다. 노드 자동 복구를 중지할 수 있지만 기본 구성을 유지하는 것이 좋습니다.

gcloud

특정 출시 채널에서 Autopilot 클러스터를 만들고 등록하려면 다음 명령어를 실행합니다.

gcloud container clusters create-auto CLUSTER_NAME \
    --location=COMPUTE_LOCATION
    --release-channel=CHANNEL

특정 출시 채널에 표준 클러스터를 만들고 등록하려면 다음 명령어를 실행합니다.

gcloud container clusters create CLUSTER_NAME \
    --location=COMPUTE_LOCATION \
    --release-channel=CHANNEL

다음을 바꿉니다.

CLUSTER_NAME: 새 클러스터의 이름입니다.
CLUSTER_LOCATION: 새 클러스터의 Compute Engine 위치입니다.
CHANNEL: 출시 채널 유형으로, rapid, regular 또는 stable 중 하나입니다.

지정할 수 있는 다른 옵션 목록은 gcloud container clusters create-auto 및 gcloud container clusters create 참고 문서를 확인하세요.

또한 --cluster-version 플래그를 사용해서 특정 버전으로 클러스터를 만들 수 있습니다. 출시 채널을 지정하지 않을 경우 GKE는 해당 버전이 제공되는 가장 성숙한 출시 채널에 클러스터를 등록합니다.

또는 출시 채널이나 클러스터 버전을 지정하지 않으면 클러스터 기본값은 기본 버전의 일반 출시 채널입니다.

기존 클러스터 등록

대상 출시 채널에서 클러스터 컨트롤 플레인 부 버전을 사용할 수 있는 기존 클러스터를 출시 채널에 등록할 수 있습니다. 대상 출시 채널에서 클러스터 컨트롤 플레인 부 버전을 사용할 수 있는지 확인하려면 출시 채널의 기본 및 사용 가능한 버전을 봅니다. 클러스터 컨트롤 플레인 버전을 대상 출시 채널에 사용 가능한 버전에 맞추는 방법에 대한 자세한 내용은 새 출시 채널 선택을 참조하세요.

GKE는 클러스터의 출시 채널 등록을 변경하는 데 다운타임이 필요하지 않습니다. 하지만 GKE는 다른 출시 채널에서 사용 가능한 자동 업그레이드가 다를 수 있습니다. 즉, 변경 후에 GKE에서 클러스터를 자동으로 업그레이드할 수 있습니다. 유지보수 기간 및 유지보수 제외를 사용하여 업그레이드 시점을 제어하는 것이 좋습니다.

등록하려면 대상 CHANNEL로 클러스터 출시 채널을 업데이트합니다.

클러스터의 출시 채널 확인

Google Cloud 콘솔이나 gcloud CLI를 사용하여 클러스터 출시 채널을 확인할 수 있습니다.

콘솔

Google Cloud 콘솔에서 Google Kubernetes Engine 페이지로 이동합니다.

Google Kubernetes Engine으로 이동
검사할 클러스터의 이름을 클릭합니다.
클러스터 기본사항 아래의 출시 채널 필드에서 값을 선택합니다(예: 일반 채널).

값이 없음이면 클러스터는 출시 채널에 등록되지 않은 것입니다.

gcloud

gcloud container clusters describe CLUSTER_NAME \
    --location=COMPUTE_LOCATION --format="value(releaseChannel.channel)"

다음을 바꿉니다.

CLUSTER_NAME: 클러스터 이름입니다.
COMPUTE_LOCATION: 클러스터의 Compute Engine 위치입니다.

출력이 비어 있으면 클러스터는 출시 채널에 등록되지 않은 것입니다.

출시 채널의 기본 및 사용 가능한 버전 보기

Google Cloud 콘솔이나 gcloud CLI를 사용하여 특정 출시 채널에서 사용할 수 있는 버전을 확인하려면 안내에 따라 사용 가능한 버전과 기본 버전을 확인합니다.

클러스터 출시 채널 변경

대상 출시 채널에서 컨트롤 플레인 부 버전을 사용할 수 있으면 클러스터 출시 채널을 변경할 수 있습니다. 클러스터 컨트롤 플레인을 사용 가능한 버전으로 업그레이드하거나 다운그레이드해야 할 수 있습니다.

대상 출시 채널에서 클러스터 컨트롤 플레인 버전을 사용할 수 있는지 확인하려면 출시 채널의 기본 및 사용 가능한 버전을 봅니다. 대상 채널에서 버전을 사용할 수 있어야 합니다.

대상 출시 채널에서 클러스터 컨트롤 플레인 버전을 이미 사용할 수 있으면 새 출시 채널을 선택할 수 있습니다.
대상 출시 채널에서 클러스터 컨트롤 플레인 버전을 사용할 수 없으면 클러스터 컨트롤 플레인을 사용 가능한 버전으로 업그레이드할 수 있습니다. 또는 대상 채널에 이전 버전만 사용할 수 있는 경우 대상 버전이 동일한 부 버전의 이전 패치 출시 버전인 경우 클러스터를 다운그레이드할 수 있습니다.

새 출시 채널을 선택하려면 대상 CHANNEL로 클러스터 출시 채널을 업데이트합니다. 새 채널을 선택할 때 클러스터가 자동으로 업그레이드되는 것을 일시적으로 방지하려면 새 채널을 선택하기 전에 유지보수 제외를 구성합니다.

클러스터가 해당 출시 채널에서 사용할 수 없는 버전을 실행 중이어서 대상 출시 채널을 선택할 수 없으면 다음을 수행하면 됩니다.

'마이너 업그레이드 없음' 범위로 유지보수 제외를 구성합니다.
대상 출시 채널이 클러스터의 Kubernetes 부 버전을 사용할 수 있을 때까지 기다립니다.
대상 출시 채널에 기존 클러스터를 등록합니다.

또는 대상 채널에서 새 클러스터를 만들고 워크로드를 마이그레이션할 수 있습니다.

클러스터 출시 채널 업데이트

Google Cloud 콘솔이나 gcloud CLI를 사용하여 클러스터 출시 채널을 변경할 수 있습니다.

콘솔

Google Cloud 콘솔에서 Google Kubernetes Engine 페이지로 이동합니다.

Google Kubernetes Engine으로 이동
검사할 클러스터의 이름을 클릭합니다.
클러스터 기본사항의 출시 채널 필드에서 를 클릭합니다.
출시 채널 드롭다운에서 대상 출시 채널을 선택합니다.
버전 업그레이드 중에 다운타임이 발생할 수 있음을 이해합니다.를 선택하여 경고를 읽고 확인합니다.
변경사항 저장을 클릭합니다.

gcloud

기존 클러스터의 출시 채널 속성을 변경합니다.

gcloud container clusters update CLUSTER_NAME \
  --release-channel CHANNEL

다음을 바꿉니다.

CLUSTER_NAME: 클러스터 이름입니다.
CHANNEL: 대상 출시 채널로, rapid, regular, stable, 표준의 경우 None 중 하나일 수 있습니다.

출시 채널에서 구독 취소

출시 채널에서 Standard 클러스터를 구독 취소할 수 있지만 클러스터를 출시 채널에 등록하지 않는 경우를 검토하여 클러스터를 출시 채널에 등록할 때와 등록하지 않을 때의 절충안을 파악하는 것이 좋습니다.

Google Cloud 콘솔, gcloud CLI 또는 Kubernetes Engine API를 사용하여 이 작업을 수행할 수 있습니다. 또한 클러스터 생성 중 Standard 클러스터를 출시 채널에 등록하지 않도록 지정할 수 있습니다. 출시 채널에서 Autopilot 클러스터를 구독 취소할 수 없습니다.

콘솔

Google Cloud 콘솔에서 Google Kubernetes Engine 페이지로 이동합니다.

Google Kubernetes Engine으로 이동
검사할 클러스터의 이름을 클릭합니다.
클러스터 기본사항의 출시 채널 필드에서 를 클릭합니다.
드롭다운 메뉴에서 정적 버전을 선택합니다.
버전 업그레이드 중에 다운타임이 발생할 수 있음을 이해합니다.를 선택하여 경고를 읽고 확인합니다.
변경사항 저장을 클릭합니다.

gcloud

클러스터의 출시 채널을 None 값으로 업데이트합니다.

gcloud container clusters update CLUSTER_NAME \
  --release-channel None

API

클러스터를 만들거나 업데이트할 때 "releaseChannel": { "channel": UNSPECIFIED}를 지정합니다.

다음 단계

출시 채널 정보