Autopilot을 기본으로 사용하도록 Standard 클러스터 설정

기본 ComputeClass, Autopilot 클러스터 보안 정책, 클러스터 0으로 축소와 같은 클러스터 설정을 사용 설정하여 Autopilot 모드 클러스터와 유사하게 작동하도록 Google Kubernetes Engine(GKE) Standard 클러스터를 구성할 수 있습니다.

이 문서는 개별 설정을 수정하거나 사용 중지할 수 있는 유연성을 갖춘 Standard 클러스터에서 Autopilot 모드의 모든 이점을 활용하려는 플랫폼 관리자와 보안 엔지니어를 대상으로 합니다. 이러한 유연성이 필요하지 않으면 대신 전용 Autopilot 클러스터를 만듭니다.

다음 개념에 익숙해야 합니다.

Autopilot 클러스터 설정

Autopilot 클러스터처럼 작동하도록 Standard 클러스터를 구성하려면 다음 설정을 모두 구성합니다.

  • Autopilot ComputeClass를 클러스터 기본값으로 설정: 기본 제공 Autopilot ComputeClass 중 하나를 설정합니다. ComputeClass를 선택하지 않는 포드는 지정된 기본 ComputeClass를 사용하여 실행됩니다. 기본 제공 ComputeClass는 모두 Autopilot 모드와 포드 기반 결제 모델을 사용합니다.
  • 클러스터를 0개 노드로 자동 확장: 클러스터에 활성 사용자 워크로드가 없는 경우 클러스터를 0개 노드로 확장하도록 클러스터 자동 확장 처리를 구성합니다. 필요에 따라 자동 확장 처리가 클러스터를 노드 0개로 확장하기 전의 지연 기간을 조정할 수 있습니다.
  • 초기 노드 0개: 클러스터 생성 중에 기본 노드 풀이 자동으로 생성되지 않도록 합니다. 기존 클러스터의 경우 수동으로 만든 노드 풀을 삭제합니다.
  • Autopilot 클러스터 보안 정책: 모든 Autopilot 보안 정책을 시행합니다. 이러한 정책은 시스템 워크로드와 ID를 보호하는 데 도움이 됩니다.

클러스터를 수정하여 다른 설정과 관계없이 이러한 설정을 변경할 수 있습니다. 예를 들어 노드 풀을 수동으로 만들어야 하는 경우 다른 설정을 변경하지 않고 해당 Autopilot 클러스터 보안 정책을 사용 중지할 수 있습니다.

유연성 및 보안 고려사항

Autopilot 클러스터를 만들면 클러스터 모드가 영구적입니다. 노드 0개로 확장, 노드 풀 수동 생성 방지, 다양한 보안 제약 조건과 같은 클러스터 설정은 변경할 수 없습니다. 하지만 Autopilot 클러스터의 모든 설정을 사용하도록 Standard 클러스터를 구성하는 경우 설정은 변경 가능합니다. 클러스터 구성을 수정할 수 있는 액세스 권한이 있는 사용자는 개별 설정을 변경하거나 사용 중지할 수 있습니다.

조직, 폴더 또는 프로젝트에서 이러한 설정 사용을 시행하기 위해 조직 관리자는 커스텀 조직 정책 제약조건을 사용할 수 있습니다. 자세한 내용은 이 문서의 커스텀 조직 정책으로 Autopilot 설정 시행 섹션을 참조하세요.

제한사항

클러스터 수준에서 Confidential GKE Node를 구성하면 GKE는 Autopilot ComputeClass를 클러스터 기본값으로 사용하는 명령어를 무시합니다.

시작하기 전에

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

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

요구사항

Standard 클러스터에서 모든 Autopilot 기능을 사용하려면 클러스터가 다음 요구사항을 충족해야 합니다.

  • 클러스터는 GKE 버전 1.37.1-gke.3020000 이상을 실행해야 합니다. 개별 설정의 버전 요구사항은 다음과 같습니다.

    • 기본 제공 Autopilot ComputeClass를 클러스터 기본값으로 설정하려면 클러스터에서 GKE 버전 1.37.1-gke.1380000 이상을 실행해야 합니다.
    • 초기 노드가 0개인 클러스터를 만들려면 클러스터에서 GKE 버전 1.37.1-gke.3020000 이상을 실행해야 합니다.
    • 클러스터를 노드 0개로 확장하도록 클러스터 자동 확장 처리를 구성하려면 클러스터에서 GKE 버전 1.37.1-gke.3020000 이상을 실행해야 합니다.

    클러스터를 호환되는 버전으로 업그레이드하려면 클러스터의 컨트롤 플레인 또는 노드 풀 수동 업그레이드를 참조하세요.

  • 클러스터는 Autopilot ComputeClasses를 사용하기 위한 모든 요구사항을 충족해야 합니다. 클러스터가 이러한 요구사항을 충족하는지 확인하려면 Standard 클러스터에서 Autopilot 모드로 워크로드 실행을 참조하세요.

필수 역할 및 권한

Autopilot 모드를 사용하기 위해 클러스터를 만들거나 업데이트하는 데 필요한 권한을 얻으려면 관리자에게 Google Cloud 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

Autopilot 모드를 사용하는 Standard 클러스터 만들기

모든 Autopilot 설정을 사용하는 새 Standard 클러스터를 만들려면 다음 명령어를 실행합니다.

gcloud container clusters create CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION \
    --num-nodes=0 \
    --default-compute-class=BUILT_IN_COMPUTECLASS_NAME \
    --enable-cluster-scale-to-zero \
    --autopilot-cluster-policies=no-system-mutation,no-system-impersonation,no-unsafe-webhooks,no-standard-node-pools

다음을 바꿉니다.

  • CLUSTER_NAME: 새 클러스터의 이름입니다.
  • CONTROL_PLANE_LOCATION: 클러스터 컨트롤 플레인의 리전입니다(예: us-central1).
  • BUILT_IN_COMPUTECLASS_NAME: 클러스터 기본값으로 사용할 기본 제공 ComputeClass입니다(예: autopilot).

필요한 경우 --cluster-scale-to-zero-delay 플래그를 사용하여 클러스터 자동 확장 처리가 클러스터를 노드 0개로 확장하기 전의 지연 기간을 조정할 수 있습니다.

gcloud container clusters create CLUSTER_NAME \
    --location=CONTROL_PLANE_LOCATION \
    --num-nodes=0 \
    --default-compute-class=BUILT_IN_COMPUTECLASS_NAME \
    --enable-cluster-scale-to-zero \
    --cluster-scale-to-zero-delay=SCALE_TO_ZERO_DELAY \
    --autopilot-cluster-policies=no-system-mutation,no-system-impersonation,no-unsafe-webhooks,no-standard-node-pools

SCALE_TO_ZERO_DELAY을 지연 시간으로 바꿉니다. 이 값은 정수와 시간 단위(예: 0s, 1m 또는 3h)를 지정해야 합니다. 최대 지연 시간은 3시간입니다. --cluster-scale-to-zero-delay 플래그를 지정하지 않으면 기본 지연 시간은 3시간입니다.

클러스터 생성 명령어가 실패하고 오류 메시지가 표시되면 오류 메시지에서 자세한 내용을 확인하세요. 가장 일반적인 오류는 다음과 같습니다.

  • 클러스터에서 지정된 플래그 중 하나를 지원하지 않는 버전을 사용합니다. 이 오류를 해결하려면 클러스터를 요구사항 섹션에 지정된 최소 필수 버전으로 업데이트하세요.
  • 클러스터 생성 명령어에 노드 풀 구성 플래그(예: --machine-type 플래그)를 지정했습니다. 새 클러스터에 초기 노드 풀이 없으므로 노드 풀 구성 플래그를 지정할 수 없습니다. 이 오류를 해결하려면 명령어에서 노드 풀 구성 플래그를 삭제합니다.
  • --default-compute-class 플래그에 커스텀 ComputeClass의 이름을 지정했습니다. 이 오류를 해결하려면 기본 제공 Autopilot ComputeClasses 중 하나를 지정합니다.

Autopilot 모드를 사용하도록 기존 Standard 클러스터 업데이트

Autopilot 모드를 사용하도록 기존 Standard 클러스터를 수정할 수 있습니다. 이 프로세스에는 수동으로 만든 노드 풀 삭제와 같이 워크로드에 중단을 일으킬 수 있는 변경사항이 포함됩니다. 예약된 유지보수 기간 동안 다음 단계를 수행합니다.

  1. 클러스터가 이 문서의 모든 요구사항을 충족하는지 확인합니다.

  2. 클러스터를 검토하고 Autopilot 클러스터 정책과의 충돌을 방지하기 위해 필요한 변경을 수행합니다. 잠재적인 변경사항에 대한 자세한 내용은 지원되는 정책을 참조하세요.

  3. Autopilot ComputeClass를 클러스터 기본값으로 설정하면 다른 ComputeClass를 선택하지 않는 수신 포드가 Autopilot 워크로드가 됩니다. ComputeClass를 선택하지 않는 워크로드에서 다음 속성을 확인합니다.

    • 워크로드가 Autopilot 보안 제약 조건을 준수하는지 확인하거나 권한이 있는 워크로드의 허용 목록을 구성합니다.
    • 포드에서 cloud.google.com/gke-nodepool 노드 선택기 또는 노드 어피니티 규칙을 찾아 삭제합니다.
    • 네임스페이스에 cloud.google.com/default-compute-class 또는 cloud.google.com/default-compute-class-non-daemonset 라벨이 있는지 확인합니다. 네임스페이스 수준 기본 ComputeClass는 클러스터 수준 기본 ComputeClass보다 우선 적용됩니다.
  4. 클러스터에 이름이 default인 커스텀 ComputeClass가 있는지 확인합니다.

    kubectl get computeclass default -o yaml
    

    출력이 비어 있으면 다음 단계로 건너뜁니다. default ComputeClass가 있으면 다음과 비슷한 출력이 표시됩니다.

    apiVersion: cloud.google.com/v1
    kind: ComputeClass
    metadata:
      annotations:
        cloud.google.com/gke-managed-default-compute-class: "true"
      name: default
    # Multiple lines are omitted here.
    

    출력에서 cloud.google.com/gke-managed-default-compute-class: "true" 주석이 metadata.annotations 필드에 있으면 다음 단계로 건너뜁니다. 이 주석이 없으면 ComputeClass를 삭제합니다.

    kubectl delete computeclass default
    
  5. 클러스터에서 수동으로 생성된 기존 노드 풀을 찾아 삭제합니다.

  6. 클러스터에 Autopilot 설정을 사용 설정합니다.

    1. 클러스터 기본 ComputeClass를 기본 제공 ComputeClass로 설정합니다.

      gcloud container clusters update CLUSTER_NAME \
          --location=CONTROL_PLANE_LOCATION \
          --default-compute-class=BUILT_IN_COMPUTECLASS_NAME
      

      다음을 바꿉니다.

      • CLUSTER_NAME: 기존 Standard 클러스터의 이름입니다.
      • CONTROL_PLANE_LOCATION: 클러스터 컨트롤 플레인의 리전입니다.
      • BUILT_IN_COMPUTECLASS_NAME: 클러스터 기본값으로 사용할 기본 제공 Autopilot ComputeClass입니다(예: autopilot).
      1. 클러스터 자동 확장을 사용 설정하고 자동 확장 처리가 클러스터를 노드 0개로 확장하도록 허용합니다.

        gcloud container clusters update CLUSTER_NAME \
            --location=CONTROL_PLANE_LOCATION \
            --enable-autoscaling \
            --enable-cluster-scale-to-zero
        

        필요한 경우 --cluster-scale-to-zero-delay 플래그를 사용하여 클러스터 자동 확장 처리가 클러스터를 노드 0개로 축소하기 전의 지연 기간을 조정할 수 있습니다.

        gcloud container clusters update CLUSTER_NAME \
            --location=CONTROL_PLANE_LOCATION \
            --enable-autoscaling \
            --enable-cluster-scale-to-zero \
            --cluster-scale-to-zero-delay=SCALE_TO_ZERO_DELAY
        

        SCALE_TO_ZERO_DELAY을 지연 기간으로 바꿉니다. 이 값은 정수와 시간 단위(예: 0s, 1m, 3h)를 지정해야 합니다. 최대 지연 시간은 3시간입니다. --cluster-scale-to-zero-delay 플래그를 지정하지 않으면 기본 지연 시간은 3시간입니다.

      2. Autopilot 클러스터 정책을 사용 설정합니다.

        gcloud container clusters update CLUSTER_NAME \
            --location=CONTROL_PLANE_LOCATION \
            --autopilot-cluster-policies=no-system-mutation,no-system-impersonation,no-unsafe-webhooks,no-standard-node-pools
        

    클러스터 업데이트 명령어 중 하나라도 실패하고 오류 메시지가 표시되면 오류 메시지에서 자세한 내용을 확인하세요. 가장 일반적인 오류는 다음과 같습니다.

    • 클러스터에서 지정된 플래그 중 하나를 지원하지 않는 버전을 사용합니다. 이 오류를 해결하려면 요구사항 섹션에 지정된 대로 클러스터를 필요한 최소 버전으로 업그레이드합니다.
    • --default-compute-class 플래그에 커스텀 ComputeClass의 이름을 지정했습니다. 이 오류를 해결하려면 기본 제공 Autopilot ComputeClasses 중 하나를 지정합니다.
    • 클러스터에 수동으로 생성된 노드 풀이 있으므로 GKE에서 no-standard-node-pools 정책을 시행할 수 없습니다. 이 오류를 해결하려면 수동으로 만든 노드 풀을 삭제합니다.

클러스터가 Autopilot 모드를 사용하는지 확인

새 클러스터 또는 기존 클러스터를 구성한 후 Autopilot 설정이 활성 상태인지 확인합니다.

  1. 클러스터에서 기본 ComputeClass, scale-to-zero, 클러스터 정책 설정이 사용 설정되어 있는지 확인합니다.

    gcloud container clusters describe CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --format="yaml(autoscaling.defaultComputeClassConfig,autoscaling.scaleToZeroConfig,autopilot.clusterPolicyConfig)"
    

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

    autoscaling:
      defaultComputeClassConfig:
        computeClass: autopilot
        enabled: true
      scaleToZeroConfig:
        enabled: true
        delay: 3h
    autopilot:
      clusterPolicyConfig:
        noManualNodePools: true
        noSystemImpersonation: true
        noSystemMutation: true
        noUnsafeWebhooks: true
    
  2. GKE가 클러스터에 관리형 default ComputeClass를 만들었는지 확인합니다.

    kubectl get computeclass default -o yaml
    

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

    출력이 비어 있으면 다음 단계로 건너뜁니다. default ComputeClass가 있으면 다음과 비슷한 출력이 표시됩니다.

    apiVersion: cloud.google.com/v1
    kind: ComputeClass
    metadata:
      annotations:
        cloud.google.com/gke-managed-default-compute-class: "true"
      name: default
    # Multiple lines are omitted here.
    spec:
      autopilot:
        enabled: true
    # Multiple lines are omitted here.
    

    이 출력에서 cloud.google.com/gke-managed-default-compute-class: "true" 주석은 GKE가 ComputeClass를 만들었음을 나타냅니다.

  3. 다른 ComputeClass를 선택하지 않는 포드를 배포할 때 포드가 Autopilot 관리형 노드에서 실행되는지 확인합니다.

    kubectl get pods -o wide
    

    출력에서 Autopilot에서 관리하는 노드의 NODE 열에는 gk3- 프리픽스가 있습니다.

개별 Autopilot 설정 수정 또는 사용 중지

Standard 클러스터의 각 Autopilot 기능은 모듈식이므로 언제든지 개별 설정을 맞춤설정하거나 사용 중지할 수 있습니다. 보안 관리자는 커스텀 조직 정책 제약 조건을 사용하여 이러한 설정을 적용할 수 있습니다. 자세한 내용은 커스텀 조직 정책으로 Autopilot 설정 시행을 참조하세요.

커스텀 조직 정책으로 Autopilot 설정 시행

Standard 클러스터의 Autopilot 설정은 클러스터 업데이트 권한이 있는 사용자가 수정하거나 사용 중지할 수 있으므로 조직 관리자는 조직 정책 서비스에서 커스텀 조직 정책 제약 조건을 사용하여 조직, 폴더 또는 프로젝트 전체에 이러한 설정을 적용할 수 있습니다. 다음 제약조건 예시에서는 모든 Autopilot 설정을 적용하지 않는 클러스터의 클러스터 생성 또는 업데이트 작업을 거부합니다.

name: organizations/ORGANIZATION_ID/customConstraints/custom.enforceAutopilotSettings
resourceTypes:
- container.googleapis.com/Cluster
methodTypes:
- CREATE
condition: >-
  "resource.ClusterPolicyConfig.no_system_mutation != true ||
  resource.ClusterPolicyConfig.no_system_impersonation != true ||
  resource.ClusterPolicyConfig.no_unsafe_webhooks != true ||
  resource.ClusterPolicyConfig.no_standard_node_pools != true ||
  resource.ScaleToZeroConfig.enabled != true ||
  !(resource.DefaultComputeClassConfig.computeClass in [
    'autopilot', 'autopilot-spot', 'autopilot-arm', 'autopilot-arm-spot'
  ])"
actionType: DENY
displayName: Enforce Autopilot cluster policies in Standard clusters
description: All new clusters must use all Autopilot settings by default.

ORGANIZATION_ID를 조직 ID로 바꿉니다.

다음 단계