리전 클러스터 만들기

이 문서에서는 클러스터 업그레이드, 자동 유지보수, 영역 중단 중 클러스터의 제어 영역 및 워크로드 가용성을 늘리기 위해 표준 리전 클러스터를 만드는 방법을 보여줍니다.

GKE Autopilot 클러스터는 항상 리전입니다.

개요

영역 클러스터 대신 리전 클러스터를 만들면 클러스터의 제어 영역이 지정된 리전의 여러 영역 간에 복제됩니다. 리전 클러스터의 노드 풀에 대해 노드 풀을 실행할 영역을 수동으로 지정하거나 제어 영역의 리전의 3개 영역 간에 각 노드 풀을 복제하는 기본 구성을 사용할 수 있습니다. 모든 영역은 클러스터의 제어 영역과 동일한 리전 내에 있어야 합니다.

리전 클러스터는 여러 영역에 걸쳐 리소스를 복제하고 추가 할당량을 소비합니다.

다양한 클러스터 가용성 유형에 대한 자세한 내용은 클러스터 구성 선택사항 정보를 참조하세요.

다음 섹션의 안내는 다음을 수행하는 방법을 보여줍니다.

단일 영역 노드 풀로 리전 클러스터를 만듭니다.
멀티 영역 노드 풀로 리전 클러스터를 만듭니다.

시작하기 전에

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

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과 같은 오류를 방지할 수 있습니다.

클러스터를 만들 수 있는 올바른 권한이 있는지 확인합니다. 최소한 Kubernetes Engine 클러스터 관리자 권한이 있어야 합니다.
새 클러스터를 Fleet에 등록하려면 필요한 API 및 권한이 있는지 확인합니다.

단일 영역 노드 풀로 리전 클러스터 만들기

다음 안내는 리전 내의 단일 영역에서 작동하는 노드 풀로 리전 클러스터를 만드는 방법을 보여줍니다. 클러스터의 제어 영역은 지정된 리전의 여러 영역 간에 복제되지만, 노드가 단일 영역에 배치되고 다른 영역으로 복제되지 않습니다.

gcloud CLI, Google Cloud 콘솔 또는 Terraform을 사용하여 클러스터를 만들 수 있습니다.

VS Code용 Cloud Code를 사용하여 GKE 애플리케이션을 개발하는 경우 Cloud Code로 클러스터 만들기를 시도해 보세요.

gcloud

gcloud CLI로 리전 클러스터를 만들려면 다음 명령어 중 하나를 사용하여 다음 변수를 바꿉니다.

CLUSTER_NAME: 새 리전 클러스터의 이름입니다.
COMPUTE_REGION: 클러스터에 사용할 리전입니다(예: us-central1).
COMPUTE_ZONE: 노드 풀의 영역입니다(예: us-central1-a). 영역은 클러스터 제어 영역과 동일한 리전에 있어야 합니다.
CHANNEL: 출시 채널 유형으로 rapid, regular, stable 또는 None 중 하나일 수 있습니다. 기본적으로 클러스터는 --cluster-version, --release-channel, --no-enable-autoupgrade, --no-enable-autorepair 플래그 중 하나 이상이 지정되지 않는 경우 regular 출시 채널에 등록됩니다.
VERSION: 클러스터에 지정하려는 버전입니다.

다음 명령어에서 선택적으로 --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com 플래그를 사용하여 Compute Engine 기본 서비스 계정 대신 클러스터의 첫 번째 노드 풀에 있는 노드가 사용하는 다른 IAM 서비스 계정을 지정할 수 있습니다. 이 플래그는 선택사항이지만 노드에 필요한 것보다 많은 권한을 갖지 않도록 최소 권한만 있는 서비스 계정을 만드는 것이 좋습니다.

특정 출시 채널 사용:

특정 출시 채널을 사용하여 새 클러스터를 만들려면 다음 명령어를 실행합니다.

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --release-channel CHANNEL

특정 버전 사용:

특정 클러스터 버전을 사용하여 새 클러스터를 만들려면 다음 명령어를 실행합니다.

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --cluster-version VERSION

출시 채널에 등록되지 않은 클러스터에 기본 버전 사용:

출시 채널에 등록되지 않은 클러스터에 기본 버전을 사용하여 새 클러스터를 만들려는 경우에는 클러스터 버전을 지정할 필요가 없지만 출시 채널을 None으로 설정해야 합니다.

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --release-channel None

예시

다음 명령어는 us-west1-c 영역의 3개 노드(기본값)와 함께 regular 출시 채널(기본값)에 등록된 리전 클러스터를 만듭니다.

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --node-locations us-west1-c

예시

다음 명령어는 us-west1-c 영역에 있는 2개 노드와 함께 regular 출시 채널(기본값)에 등록된 리전 클러스터를 만듭니다.

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --node-locations us-west1-c \
    --num-nodes 2

콘솔

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

Google Kubernetes Engine으로 이동
만들기를 클릭합니다.
클러스터 기본사항 섹션에서 다음을 완료합니다.
1. 클러스터의 이름을 입력합니다.
2. 위치 유형에 대해 리전을 선택한 다음 클러스터에 대해 리전을 선택합니다.
3. 단일 영역에서 실행할 때와 같이 기본 노드 위치를 재정의하려면 기본 노드 위치 지정 체크박스를 선택한 후 노드 풀을 실행할 영역을 선택합니다.
4. 출시 채널을 선택합니다. 드롭다운 목록에서 선택적으로 채널 없음을 선택할 수 있지만 이 옵션을 선택하기 전 출시 채널에서 클러스터를 등록하지 않아야 하는 경우를 검토하는 것이 좋습니다. GKE는 특정 출시 채널에 등록되지 않은 클러스터를 안정화 버전 채널의 버전으로 자동으로 업그레이드합니다.
5. 선택사항: 버전 드롭다운 목록에서 제어 영역 버전을 지정합니다.
선택사항(GKE Enterprise에서 사용 가능): 새 클러스터를 Fleet에 등록하려는 경우 Fleet 등록 섹션으로 이동하여 Google Cloud 콘솔의 새 클러스터 생성 및 등록 지침에 따라 클러스터 등록을 완료하세요.
탐색창의 노드 풀에서 default-pool을 클릭합니다.
노드 풀 세부정보 섹션에서 다음을 완료합니다.
1. 기본 노드 풀의 이름을 입력합니다.
2. 선택사항: 노드 버전을 선택합니다.
3. 클러스터에서 만들 노드 수를 입력합니다. 노드 및 해당 리소스(예: 방화벽 경로)에 사용 가능한 리소스 할당량이 있어야 합니다.
4. 선택사항: 노드 자동 업그레이드를 사용 중지하도록 선택할 수 있지만 이 옵션을 선택하기 전에 노드 자동 업그레이드를 사용 중지하기 전 고려사항을 검토하는 것이 좋습니다.
탐색창의 노드 풀에서 노드를 클릭합니다.
이미지 유형 드롭다운 목록에서 노드 이미지를 선택합니다.
인스턴스에 사용할 기본 머신 구성을 선택합니다. 요금은 머신 유형마다 다르게 청구됩니다. 기본 머신 유형은 e2-medium입니다. 머신 유형 가격 정보는 머신 유형 가격표를 참조하세요.
부팅 디스크 유형 드롭다운 목록에서 디스크 유형을 선택합니다.
부팅 디스크 크기를 입력합니다.
선택사항: 탐색창의 노드 풀에서 보안을 클릭합니다.
선택사항: 서비스 계정 드롭다운 목록에서 Google Cloud API를 호출할 때 사용할 애플리케이션의 Identity and Access Management(IAM) 서비스 계정을 선택합니다. 노드에 필요한 것보다 많은 권한을 갖지 않도록 기본 서비스 계정을 사용하는 대신 최소 권한만 있는 서비스 계정을 사용하는 것이 좋습니다.
만들기를 클릭합니다.

Terraform

Terraform을 사용하여 단일 영역 노드 풀이 있는 리전 클러스터를 만들려면 다음 예시를 참조하세요.

resource "google_container_cluster" "default" {
  name               = "gke-standard-regional-single-zone"
  location           = "us-west1"
  node_locations     = ["us-west1-c"]
  initial_node_count = 2

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Terraform 사용에 대한 자세한 내용은 GKE에 대한 Terraform 지원을 참조하세요.

kubectl을 사용하여 클러스터와 상호작용

클러스터를 만든 후에는 kubectl을 구성해야 명령줄에서 클러스터와 상호작용할 수 있습니다.

다중 영역 노드 풀로 리전 클러스터 만들기

다음 안내에서는 기본 설정인 다중 영역 노드 풀로 리전 클러스터를 만드는 방법을 보여줍니다. 클러스터의 제어 영역 및 노드는 지정된 리전의 여러 영역 간에 복제됩니다.