클러스터 업데이트

이 페이지에서는 관리자 클러스터 및 사용자 클러스터에서 어떤 설정을 업데이트할 수 있는지에 대하여 설명합니다.

일반적으로 구성 파일에서 단일 설정을 변경한 다음 적절한 매개변수로 gkectl update 명령어를 실행하게 됩니다. 여러 설정을 업데이트하려면 한 번에 하나씩 설정을 변경하고 명령어를 반복해서 실행하세요.

gkectl update 명령어는 업데이트할 기능에 해당하는 매개변수와 함께 다음 형식 중 하나를 사용합니다.

클러스터에서 업데이트 가능한 항목과 불가능한 항목

관리자 클러스터 및 사용자 클러스터 모두 많은 기능이 클러스터를 만든 후에는 업데이트가 불가능합니다.

관리자 클러스터에서 업데이트 가능한 설정을 알아보려면 다음을 실행하세요.

gkectl update admin --help

사용자 클러스터에서 업데이트 가능한 설정을 알아보려면 다음을 실행하세요.

gkectl update cluster --help

관리자 클러스터 업데이트

관리자 클러스터의 여러 기능을 업데이트할 수 있습니다.

관리자 클러스터의 OS 이미지 유형 업데이트

Ubuntu 또는 COS를 사용하려면 관리자 클러스터의 OS 이미지 유형을 업데이트합니다.

고정 IP 주소 추가 할당

구성에서 고정 IP 주소가 사용되는 경우 관리자 워크스테이션 또는 관리자 클러스터를 업그레이드할 때 사용 중인 주소 수를 확인하고 필요한 경우 추가해야 합니다.

사용자 클러스터의 제어 영역 노드에 대해 노드 크기 조절 사용 설정 또는 사용 중지

사용자 클러스터에 대해 제어 영역 노드의 자동 크기 조정을 사용 설정 또는 사용 중지할 수 있습니다. 이들 노드는 관리자 클러스터에 있습니다.

클러스터 백업 사용 설정 또는 사용 중지

관리자 클러스터의 경우 클러스터 백업을 사용 설정하거나 클러스터 백업을 사용 중지할 수 있습니다.

vSphere 리소스 측정항목 사용 설정 또는 사용 중지

관리자 클러스터 구성 파일에서 stackdriver.disableVsphereResourceMetrics 값을 변경하는 경우 이 명령어를 실행하여 구성을 업데이트합니다.

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

관리자 클러스터에 대해 vCenter 인증서 참조 업데이트

vCenter 인증서가 변경된 경우 vCenter 인증서 참조를 업데이트합니다. 관리자 클러스터 및 모든 사용자 클러스터를 업데이트해야 합니다.

관리자 클러스터의 부가기능 노드 크기 자동 조절 사용 설정(미리보기)

관리자 클러스터의 부가기능 노드 크기 자동 조절을 사용 설정하거나 사용 중지할 수 있습니다.

관리자 클러스터의 자동 노드 복구 사용 설정 또는 사용 중지(미리보기)

관리자 클러스터 구성 파일에서 적절한 설정을 변경하고 gkectl update admin 명령어를 실행하여 관리자 클러스터에 대해 자동 노드 복구를 사용 설정 또는 사용 중지할 수 있습니다.

안티어피니티 그룹 사용 또는 사용 중지(미리보기)

관리자 클러스터 구성 파일에서 antiAffinityGroups.enabled 값을 변경하는 경우 다음 명령어를 실행하여 구성을 업데이트합니다.

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

다음을 바꿉니다.

  • ADMIN_CLUSTER_KUBECONFIG: kubeconfig 파일의 경로입니다. 파일이 현재 디렉터리에 있고 이름이 kubeconfig이면 이 플래그를 생략할 수 있습니다.

  • ADMIN_CLUSTER_CONFIG_FILE: 관리자 클러스터 구성 파일의 경로입니다. 파일이 현재 디렉터리에 있고 이름이 admin-cluster.yaml이면 이 플래그를 생략할 수 있습니다.

관리자 클러스터의 Cloud 감사 로그에 대한 로깅 사용 설정 또는 사용 중지

Cloud 감사 로그에 로깅을 사용 설정하려면 관리자 클러스터 구성 파일의 cloudAuditLogging 섹션을 입력한 후 클러스터를 업데이트합니다.

Cloud 감사 로그의 로깅을 중지하려면 관리자 클러스터 구성 파일에서 cloudAuditLogging 섹션을 삭제한 후 클러스터를 업데이트합니다.

이 섹션은 Google Cloud console에서 사용자 클러스터의 수명 주기를 관리하려는 경우 관리자 클러스터에 필요합니다.

클러스터를 업데이트하려면 다음 안내를 따르세요.

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

다음을 바꿉니다.

  • ADMIN_CLUSTER_KUBECONFIG: 관리자 클러스터 kubeconfig 파일의 경로입니다.

  • ADMIN_CLUSTER_CONFIG_FILE: 관리자 클러스터 구성 파일의 경로입니다.

관리자 클러스터의 로깅 및 모니터링 사용 설정 또는 중지

Cloud Logging 및 Cloud Monitoring을 사용 설정하려면 관리자 클러스터 구성 파일에서 stackdriver 섹션을 작성한 후 클러스터를 업데이트합니다.

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config ADMIN_CLUSTER_CONFIG_FILE

다음을 바꿉니다.

  • ADMIN_CLUSTER_KUBECONFIG: 관리자 클러스터 kubeconfig 파일의 경로입니다.

  • ADMIN_CLUSTER_CONFIG_FILE: 관리자 클러스터 구성 파일의 경로입니다.

Cloud Logging 및 Cloud Monitoring을 중지하려면 관리자 클러스터 구성 파일에서 stackdriver 섹션을 삭제한 후 클러스터를 업데이트합니다.

stackdriver 섹션은 기본적으로 필요하므로 섹션을 삭제하려면 --skip-validation-stackdriver 플래그를 포함해야 합니다.

gkectl update admin --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config ADMIN_CLUSTER_CONFIG_FILE \
    --skip-validation-stackdriver

stackdriver 섹션은 Google Cloud 콘솔에서 사용자 클러스터의 수명 주기를 관리하려는 경우 관리자 클러스터에 필요합니다.

관리자 클러스터 등록

관리자 클러스터를 처음 만들 때 만들기 전에 관리자 클러스터 구성 파일의 gkeConnect 섹션을 작성하여 등록할 수 있습니다. 만들 때 클러스터를 등록하지 않았으면 나중에 구성 파일을 수정해서 gkeConnect 섹션을 추가하고 gkectl update admin 명령어를 실행하여 클러스터를 등록할 수 있습니다.

이 섹션은 Google Cloud console에서 사용자 클러스터의 수명 주기를 관리하려는 경우 관리자 클러스터에 필요합니다.

관리자 클러스터의 연결-등록 서비스 계정 키 순환

연결-등록 서비스 계정 키를 순환하려면 서비스 계정 키 순환의 설명대로 gkectl update credentials 명령어를 사용합니다.

사용자 클러스터 업데이트

사용자 클러스터 파일의 설정을 수정한 후 적절한 매개변수로 gkectl update cluster를 실행하여 사용자 클러스터를 업데이트할 수 있습니다. 사용자 클러스터에 대해 수행 가능한 변경사항은 다음과 같습니다.

고정 IP 주소 추가 할당

구성에서 고정 IP 주소를 사용하는 경우 다음 중 하나를 변경할 때 사용 중인 IP 주소 수를 확인하고 필요한 경우 추가해야 합니다.

nodePool 설정을 업데이트하여 사용자 클러스터 크기 조정

nodePools 섹션에서 replicas 값을 업데이트한 후 gkectl update cluster 명령어를 실행하여 사용자 클러스터를 크기 조절할 수 있습니다.

vSphere 리소스 측정항목 사용 설정 또는 사용 중지

사용자 클러스터 구성 파일에서 vSphere 리소스 측정항목을 사용 설정 또는 사용 중지한 후 gkectl update cluster 명령어를 실행할 수 있습니다.

사용자 클러스터에 대해 vCenter 인증서 참조 업데이트

vCenter 인증서가 변경된 경우 vCenter 인증서 참조를 업데이트합니다. 관리자 클러스터 및 모든 사용자 클러스터를 업데이트해야 합니다.

사용자 클러스터 등록

클러스터를 만들 때는 먼저 사용자 클러스터 구성 파일에서 gkeConnect 섹션을 작성하여 등록할 수 있습니다. 만들 때 클러스터를 등록하지 않았으면 나중에 구성 파일을 수정해서 gkeConnect 섹션을 추가하고 gkectl update cluster 명령어를 실행하여 기존 사용자 클러스터를 등록할 수 있습니다.

사용자 클러스터의 로깅 및 모니터링 사용 설정 또는 중지(미리보기)

로깅 및 모니터링을 사용 설정하려면 사용자 클러스터 구성 파일에서 stackdriver 섹션을 작성한 후 클러스터를 업데이트합니다.

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG --config USER_CLUSTER_CONFIG_FILE

다음을 바꿉니다.

  • ADMIN_CLUSTER_KUBECONFIG: 관리자 클러스터 kubeconfig 파일의 경로입니다.

  • USER_CLUSTER_CONFIG_FILE: 사용자 클러스터 구성 파일의 경로입니다.

로깅 및 모니터링을 사용 중지하려면 사용자 클러스터 구성 파일에서 stackdriver 섹션을 삭제한 후 클러스터를 업데이트합니다.

stackdriver 섹션은 기본적으로 필요하므로 섹션을 삭제하려면 --skip-validation-stackdriver 플래그를 포함해야 합니다.

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
    --config USER_CLUSTER_CONFIG_FILE
    --skip-validation-stackdriver

사용자 클러스터의 자동 노드 복구 사용 설정 또는 사용 중지

사용자 클러스터 구성 파일에서 적절한 설정을 변경하고 gkectl update cluster 명령어를 실행하여 사용자에 대해 자동 노드 복구를 사용 설정 또는 사용 중지할 수 있습니다.

사용자 클러스터의 노드 자동 크기 조절

사용자 클러스터에서 노드의 자동 크기 조절을 사용 설정하려면 사용자 클러스터 구성 파일을 수정하고 gkectl update 명령어를 실행합니다.

사용자 클러스터에서 Cloud Audit Logging 사용 설정 또는 사용 중지

Cloud Audit Logging을 사용 설정하거나 Cloud Audit Logging을 사용 중지할 수 있습니다.

vSphere CSI 드라이버 사용 중지

기본적으로 vSphere CSI 드라이버는 사용 설정됩니다. vSphere CSI 드라이버를 사용 중지할 수 있습니다.

사용자 클러스터의 연결-등록 서비스 계정 키 순환

연결-등록 서비스 계정 키를 순환하려면 서비스 계정 키 순환의 설명대로 gkectl update credentials 명령어를 사용합니다.

containerd 및 Windows Dataplane V2를 사용하도록 Windows Server 구성 업데이트

구성에 Windows Server OS 노드의 노드 풀이 포함된 경우 Docker 및 Flannel은 다음 출시 버전에서 지원 중단될 예정입니다. 대신 containerd 및 Windows Dataplane V2를 사용하도록 사용자 클러스터를 지금 업데이트하는 것이 좋습니다.

이 업데이트를 수행하려면 다음 안내를 따르세요.

  1. 사용자 클러스터 구성 파일에서 enableWindowsDataplaneV2를 true로 설정합니다.

  2. gkectl update cluster 명령어를 실행합니다.

MetalLB 구성 업데이트

사용자 클러스터 구성 파일에서 MetalLB 주소 풀을 업데이트할 수 있습니다. 또한 nodePools 섹션에서 enableLoadBalancer 값을 업데이트하여 노드 풀에서 MetalLB를 사용 설정하거나 중지할 수 있습니다. 구성 파일에서 해당 항목을 변경하고 gkectl update cluster를 호출합니다.

gkectl update cluster --kubeconfig ADMIN_CLUSTER_KUBECONIFG --config USER_CLUSTER_CONFIG

다음을 바꿉니다.

  • ADMIN_CLUSTER_KUBECONFIG: 관리자 클러스터 kubeconfig 파일의 경로입니다.

  • USER_CLUSTER_CONFIG_FILE: 사용자 클러스터 구성 파일의 경로입니다.

노드 풀 호스트 그룹 업데이트

다음 작업을 포함하는 사용자 클러스터 노드 풀 구성에서 vsphere.hostgroups 필드를 변경하여 노드 풀과 연결된 호스트 그룹을 업데이트할 수 있습니다.

  • 지정된 호스트 그룹을 사용하여 새 노드 풀을 만듭니다.
  • 호스트 그룹이 없는 기존 노드 풀에 호스트 그룹을 제공합니다.
  • 한 호스트 그룹에서 다른 호스트 그룹으로 기존 노드 풀을 업데이트합니다.
  • 노드 풀에서 기존 호스트 그룹을 삭제합니다.

vsphere.hostgroups 필드를 변경한 후 gkectl update cluster 명령어를 실행하여 노드 풀을 업데이트합니다.