영역 클러스터 만들기

이 페이지에서는 Google Kubernetes Engine(GKE)에서 기본 기능이 사용 설정된 Standard 영역 클러스터를 만드는 방법을 보여줍니다. 영역 클러스터는 단일 영역에 단일 컨트롤 플레인 인스턴스가 있습니다. 가용성 요구사항에 따라 영역 클러스터의 노드를 단일 영역 또는 여러 영역에 배포하도록 선택할 수 있습니다.

권장사항: 리전 클러스터가 영역 클러스터보다 높은 가용성을 제공하므로 이 클러스터를 사용하여 프로덕션 워크로드를 실행합니다. 리전 클러스터에서 컨트롤 플레인은 리전의 여러 영역에 걸쳐 복제됩니다.

이 페이지는 클러스터를 만들고 구성해야 하며 GKE에 워크로드를 배포하는 오퍼레이터, Cloud Architect, 개발자를 대상으로 합니다. Google Cloud콘텐츠에서 참조하는 일반적인 역할 및 예시 태스크에 대해 자세히 알아보려면 일반 GKE 사용자 역할 및 태스크를 참조하세요.

이 페이지를 읽기 전에 클러스터 구성 선택사항을 숙지해야 합니다.

시작하기 전에

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

  • Google Kubernetes Engine API를 사용 설정합니다.
  • Google Kubernetes Engine API 사용 설정
  • 이 태스크에 Google Cloud CLI를 사용하려면 gcloud CLI를 설치한 후 초기화합니다. 이전에 gcloud CLI를 설치했으면 gcloud components update 명령어를 실행하여 최신 버전을 가져옵니다. 이전 gcloud CLI 버전에서는 이 문서의 명령어를 실행하지 못할 수 있습니다.

GKE의 IAM 서비스 계정 설정

GKE는 노드에 연결된 IAM 서비스 계정을 사용하여 로깅 및 모니터링과 같은 시스템 태스크를 실행합니다. 적어도 이러한 노드 서비스 계정에는 프로젝트에 대한 Kubernetes Engine 기본 노드 서비스 계정(roles/container.defaultNodeServiceAccount) 역할이 있어야 합니다. 기본적으로 GKE는 프로젝트에 자동으로 생성되는 Compute Engine 기본 서비스 계정을 노드 서비스 계정으로 사용합니다.

Compute Engine 기본 서비스 계정에 roles/container.defaultNodeServiceAccount 역할을 부여하려면 다음 단계를 완료합니다.

콘솔

  1. 시작 페이지로 이동합니다.

    시작 페이지로 이동

  2. 프로젝트 번호 필드에서 클립보드에 복사를 클릭합니다.
  3. IAM 페이지로 이동합니다.

    IAM으로 이동

  4. 액세스 권한 부여를 클릭합니다.
  5. 새 주 구성원 필드에 다음 값을 지정합니다.
    PROJECT_NUMBER-compute@
    PROJECT_NUMBER를 복사한 프로젝트 번호로 바꿉니다.
  6. 역할 선택 메뉴에서 Kubernetes Engine 기본 노드 서비스 계정 역할을 선택합니다.
  7. 저장을 클릭합니다.

gcloud

  1. Google Cloud 프로젝트 번호를 찾습니다.
    gcloud projects describe PROJECT_ID \
        --format="value(projectNumber)"

    PROJECT_ID를 프로젝트 ID로 바꿉니다.

    출력은 다음과 비슷합니다.

    12345678901
    
  2. Compute Engine 기본 서비스 계정에 roles/container.defaultNodeServiceAccount 역할을 부여합니다.
    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:PROJECT_NUMBER-compute@" \
        --role="roles/container.defaultNodeServiceAccount"

    PROJECT_NUMBER를 이전 단계의 프로젝트 번호로 바꿉니다.

영역 클러스터 만들기

새 영역 클러스터를 만들 때 지정해야 하는 최소 정보는 이름, 프로젝트(일반적으로 현재 프로젝트), 영역(일반적으로 명령줄 도구의 기본 위치)이며 다른 모든 값에는 기본 설정을 사용합니다. 그러나 구성 설정은 더 많으며 이 섹션에서는 그중 일부만 설명하고 클러스터를 만든 후에는 변경할 수 없는 설정도 있습니다. 클러스터를 만든 후에는 변경할 수 없는 설정을 이해하고 클러스터를 다시 만들지 않으려면 클러스터를 만들 때 올바른 설정을 선택해야 합니다.

클러스터 구성 선택사항 정보에서 클러스터 구성 옵션에 대한 개요를, gcloud container clusters create 및 Terraform google_container_cluster 참조 가이드에서 가능한 옵션의 전체 목록을 확인할 수 있습니다.

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

VS Code용 Cloud Code로 GKE 애플리케이션을 개발하는 경우 Cloud Code로 클러스터를 생성해 보세요.

gcloud

gcloud CLI로 영역 클러스터를 만들려면 다음 명령어 중 하나를 사용합니다.

다음을 바꿉니다.

  • CLUSTER_NAME: 새 클러스터의 이름입니다.
  • CHANNEL: 출시 채널 유형으로 rapid, regular, stable 또는 None(지원 중단됨) 중 하나일 수 있습니다. 기본적으로 클러스터는 regular 출시 채널에 등록됩니다.
  • CONTROL_PLANE_LOCATION: 클러스터 컨트롤 플레인의 Compute Engine 영역입니다.
  • VERSION: 클러스터에 지정하려는 버전입니다.
  • COMPUTE_ZONE,COMPUTE_ZONE1,[...]: 노드가 생성된 영역. 클러스터에 필요한 만큼 많은 영역을 지정할 수 있습니다. 모든 영역은 --location 플래그에 지정된 대로 클러스터의 컨트롤 플레인과 동일한 리전에 있어야 합니다. 영역 클러스터의 경우 --node-locations에 클러스터의 기본 영역이 포함되어야 합니다.

Compute Engine 기본 서비스 계정 대신 노드에서 사용할 수 있는 최소 권한의 IAM 서비스 계정을 지정하는 것이 좋습니다. 최소 권한의 서비스 계정을 만드는 방법은 최소 권한 서비스 계정 사용을 참조하세요.

gcloud CLI에서 커스텀 서비스 계정을 지정하려면 명령어에 다음 플래그를 추가합니다.

--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.

SERVICE_ACCOUNT_NAME을 최소 권한 서비스 계정 이름으로 바꿉니다.

특정 출시 채널 사용:

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

gcloud container clusters create CLUSTER_NAME \
    --release-channel CHANNEL \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

특정 버전 사용:

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

gcloud container clusters create CLUSTER_NAME \
    --cluster-version VERSION \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

예시

다음 명령어는 example-cluster라는 멀티영역 클러스터를 만듭니다. 여기서 클러스터 컨트롤 플레인은 us-east4-a 영역에 있고 노드 위치 3개가 있습니다. 클러스터가 regular 출시 채널에 등록됩니다.

--num-nodes 플래그를 생략한 경우 클러스터에서 생성되는 기본 영역별 노드 수는 3개입니다. 3개의 영역이 지정되었으므로 이 명령어는us-east4-a, us-east4-b, us-east4-c에 각각 3개씩 9노드 클러스터를 만듭니다. GKE 버전 1.37.1-gke.1153000 이상에서는 --num-nodes 플래그를 0 값으로 설정하여 노드가 없는 클러스터를 만들 수 있습니다.

gcloud container clusters create example-cluster \
    --location us-east4-a \
    --node-locations us-east4-a,us-east4-b,us-east4-c

콘솔

Google Cloud 콘솔을 사용하여 영역 클러스터를 만들려면 다음 태스크를 수행합니다.

  1. Google Cloud 콘솔에서 Kubernetes 클러스터 만들기 페이지로 이동합니다.

    Kubernetes 클러스터 만들기로 이동

  2. 클러스터 기본사항 섹션에서 다음을 완료합니다.

    1. 클러스터의 이름을 입력합니다.
    2. 위치 유형에서 영역을 선택한 후 클러스터의 영역을 선택합니다.
    3. 멀티 영역 클러스터를 만드는 경우 기본 노드 위치 지정 체크박스를 선택한 후 노드 풀을 실행할 추가 영역을 선택합니다.

    4. 출시 채널을 선택합니다. 선택적으로 채널 없음을 선택할 수 있지만 이 구성 옵션은 지원 중단되었으며 삭제될 예정입니다. 자세한 내용은 출시 채널에 등록되지 않은 클러스터를 참조하세요.

    5. 선택사항: 버전 드롭다운 목록에서 제어 영역 버전을 지정합니다.

  3. 선택사항: 새 클러스터의 다른 설정을 구성합니다.

  4. 선택사항: 새 클러스터를 Fleet에 등록하려면 고급 설정 섹션으로 이동하여 Google Cloud 콘솔의 새 클러스터 만들기 및 등록 지침을 따라 클러스터 등록을 완료합니다.

  5. 자체 노드 풀을 만들고 구성하려면 다음 단계를 따르세요.

    1. 노드 풀 추가를 클릭합니다.
    2. 필요한 변경사항 대화상자에서 변경을 클릭합니다.

    탐색 메뉴에 default-pool이라는 노드 풀이 표시됩니다.

  6. 선택사항: 노드 풀이 없는 클러스터를 만들려면 다음 단계를 따르세요.

    1. 탐색 메뉴에서 default-pool을 클릭합니다.
    2. 노드 풀 삭제를 클릭합니다.
    3. 클러스터의 나머지 설정을 구성한 후 만들기를 클릭합니다.
  7. 선택사항: 클러스터에 노드 풀을 추가하려면 노드 풀 추가를 클릭합니다. 탐색 메뉴에 새 노드 풀이 표시됩니다.

  8. 노드 풀의 기본 설정을 구성합니다.

    1. 탐색 메뉴의 노드 풀 섹션에서 노드 풀 이름을 클릭합니다. 사용자 관리형 노드 풀 세부정보 페이지가 열립니다.
    2. 이름 필드에 노드 풀 이름을 입력합니다.
    3. 크기 섹션의 노드 수 필드에서 만들 노드 수를 지정합니다. 노드 및 해당 리소스(예: 방화벽 경로)에 사용 가능한 리소스 할당량이 있어야 합니다. GKE 버전 1.37.1-gke.1153000 이상에서는 0 값을 지정하여 빈 노드 풀을 만들 수 있습니다.
  9. 노드를 실행하는 VM 인스턴스의 설정을 구성합니다.

    1. 탐색 메뉴에서 선택한 노드 풀의 펼쳐진 섹션에서 노드를 클릭합니다.
    2. 이미지 유형 드롭다운 목록에서 노드 이미지를 선택합니다.
    3. 인스턴스에 사용할 기본 머신 구성을 선택합니다. 요금은 머신 유형마다 다르게 청구됩니다. 기본 머신 유형은 e2-medium입니다. 머신 유형 가격 정보는 머신 유형 가격표를 참조하세요.
    4. 부팅 디스크 유형 드롭다운 목록에서 디스크 유형을 선택합니다.
    5. 부팅 디스크 크기 필드에서 부팅 디스크의 크기(GB)를 지정합니다.
  10. 노드 풀의 보안 설정을 구성합니다.

    1. 탐색 메뉴에서 선택한 노드 풀의 펼쳐진 섹션에서 보안을 클릭합니다.
    2. 원하는 경우 노드에 커스텀 IAM 서비스 계정을 지정합니다.
      1. 고급 설정 페이지에서 보안 섹션을 펼칩니다.
      2. 서비스 계정 메뉴에서 원하는 서비스 계정을 선택합니다.

      Compute Engine 기본 서비스 계정 대신 노드에서 사용할 수 있는 최소 권한의 IAM 서비스 계정을 지정하는 것이 좋습니다. 최소 권한의 서비스 계정을 만드는 방법은 최소 권한 서비스 계정 사용을 참조하세요.

  11. 만들기를 클릭합니다.

Terraform

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

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-single-zone"
  location           = "us-central1-a"
  initial_node_count = 1
}

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

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-multi-zone"
  location           = "us-central1-a"
  node_locations     = ["us-central1-b", "us-central1-c"]
  initial_node_count = 2
}

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

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

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

노드가 없는 영역 클러스터 만들기

GKE 버전 1.37.1-gke.1153000 이상에서는 다음 방법 중 하나로 노드가 없는 영역 클러스터를 만들 수 있습니다.

  • 기본 노드 풀 만들기 건너뛰기: GKE가 클러스터에 노드 풀을 추가하지 않습니다. Autopilot ComputeClasses, 노드 풀 자동 생성 또는 나중에 만드는 커스텀 노드 풀을 사용하여 워크로드를 실행하려면 이 옵션을 사용합니다.
  • 빈 노드 풀 만들기: GKE가 노드가 없는 노드 풀을 만듭니다. 실제 노드를 만들지 않고 클러스터 생성 중에 노드 풀 설정을 맞춤설정하려면 이 옵션을 사용합니다.

노드가 0개인 클러스터를 만들면 클러스터에 노드가 하나 이상 존재할 때까지 시스템 포드가 예약할 수 없는 상태로 유지됩니다. 노드가 없는 영역 클러스터를 만들려면 다음 옵션 중 하나를 선택합니다.

gcloud

  • 기본 노드 풀 생성을 건너뛰려면 gcloud container clusters create 명령어에서 --num-nodes=0 플래그만 사용합니다.

    gcloud container clusters create CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --num-nodes=0
    

    다음을 바꿉니다.

    • CLUSTER_NAME: 새 영역 클러스터의 이름입니다.
    • CONTROL_PLANE_LOCATION: 클러스터 컨트롤 플레인의 Compute Engine 영역입니다(예: us-central1-a).

    --machine-type, --disk-type 또는 --disk-size 플래그와 같은 다른 노드 풀 구성 플래그를 지정하면 GKE에서 구성할 노드 풀이 없으므로 명령어가 실패합니다.

  • 빈 노드 풀이 있는 클러스터를 만들려면 gcloud container clusters create 명령어에서 --num-nodes=0 플래그와 --node-pool-name 플래그를 사용합니다.

    gcloud container clusters create CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --num-nodes=0 \
        --node-pool-name=NODEPOOL_NAME
    

    NODEPOOL_NAME을 빈 노드 풀의 이름으로 바꿉니다. 다른 노드 구성 플래그를 지정하여 빈 노드 풀의 노드를 맞춤설정할 수 있습니다.

콘솔

  1. Google Cloud 콘솔에서 Kubernetes 클러스터 만들기 페이지로 이동합니다.

    Kubernetes 클러스터 만들기로 이동

  2. 클러스터 이름을 지정합니다.

  3. 위치 유형 섹션에서 영역을 선택합니다.

  4. 영역 드롭다운 목록에서 클러스터의 컨트롤 플레인 영역을 선택합니다.

  5. 기본 노드 풀 생성을 건너뛰거나 빈 노드 풀을 만듭니다.

    • 기본 노드 풀 만들기를 건너뛰려면 기본 모드 섹션에서 Autopilot 옵션이 선택되어 있는지 확인합니다. 또는 기본 노드 풀 생성을 트리거한 후 삭제합니다.

      1. 노드 풀 추가를 클릭합니다.
      2. 필요한 변경사항 대화상자에서 변경을 클릭합니다. default-pool이라는 노드 풀이 표시됩니다.
      3. 탐색 메뉴에서 default-pool을 클릭합니다.
      4. 노드 풀 삭제를 클릭합니다.

      이 단계에서는 노드 풀이 없고 Autopilot 모드를 사용하여 ComputeClass를 선택하지 않는 워크로드를 실행하는 클러스터를 만듭니다. 기본 모드 섹션에서 사용자 관리형 노드 풀 옵션을 선택하여 Autopilot 모드를 사용하지 못하게 할 수도 있습니다.

    • 빈 노드 풀을 만들려면 다음 단계를 따르세요.

      1. 노드 풀 추가를 클릭합니다.
      2. 필요한 변경사항 대화상자에서 변경을 클릭합니다. default-pool이라는 노드 풀이 표시됩니다.
      3. 탐색 메뉴에서 default-pool을 클릭합니다.
      4. 노드 수 필드에 0 값을 지정합니다.
  6. 클러스터의 나머지 설정을 구성한 후 만들기를 클릭합니다.

Terraform

  • 기본 노드 풀 만들기를 건너뛰려면 google_container_cluster 리소스에서 initial_node_count 필드를 0 값으로 설정합니다.
  • 빈 초기 노드 풀을 만들려면 다음을 수행합니다.

    1. google_container_cluster 리소스에서 initial_node_count 필드를 0 값으로 설정합니다.
    2. google_container_node_pool 리소스를 추가하고 node_count 필드를 0 값으로 설정합니다.

노드가 없는 클러스터를 만든 후에는 다음과 같은 방법으로 노드를 프로비저닝할 수 있습니다.

클러스터 템플릿

GKE는 이전에 클러스터용 템플릿을 지원했습니다. 이러한 템플릿은 Google Cloud 콘솔에서 삭제되었지만 다음 링크에서 계속 액세스할 수 있습니다.

다음 단계