Google Distributed Cloud는 클러스터를 만들고 클러스터 수명 주기 작업(업데이트, 업그레이드, 삭제)을 관리할 수 있는 여러 도구를 제공합니다.
gkectl은 온프레미스 데이터 센터의 관리자 워크스테이션에서 실행하는 명령줄 도구입니다. 클러스터 네트워크, 부하 분산, 기타 클러스터 기능을 설명하는 구성 파일을 만듭니다. gkectl에 대한 명령줄에서 이 파일을 지정합니다.
Google Cloud 콘솔, Google Cloud CLI 또는 Terraform - 네트워크가 GKE On-Prem API에 연결된 모든 컴퓨터에서 실행할 수 있습니다. 이러한 표준 도구는 Google Cloud 인프라에서 실행되는 GKE On-Prem API를 사용합니다. 통칭해서 이러한 표준 도구를 GKE On-Prem API 클라이언트라고 합니다. 클러스터의 수명 주기를 관리하려면 GKE On-Prem API가 클러스터를 만들 때 지정한 Google Cloud 리전에서 Google Cloud에 클러스터 상태에 대한 메타데이터를 저장해야 합니다. 이 메타데이터를 사용하면 API에서 클러스터 수명 주기를 관리할 수 있으며 워크로드별 데이터는 포함되지 않습니다.
클러스터를 만드는 데 사용하는 도구에 관계없이 클러스터 노드 머신과 부하 분산기 VIP의 IP 주소와 같이 수집하여 도구에 제공하는 정보는 동일합니다.
이 옵션을 선택하면 사용 사례 및 환경에 가장 적합한 도구를 선택할 수 있습니다. 예를 들면 다음과 같습니다.
개발 환경에서 처음 설치하는 경우 사용자 인터페이스가 추가 안내 및 도움말을 제공하는 Google Cloud 콘솔을 사용하는 것이 좋습니다.
조직에서 이미 gcloud CLI 또는 Terraform을 사용하여 다른 Google Cloud 리소스를 관리하는 경우 이러한 도구도 Google Distributed Cloud에 사용할 수 있습니다.
조직에 규제 요구사항 또는 제한사항이 있으면 Google Cloud 에 대한 의존도를 제한하고 관리자 워크스테이션에서 gkectl을 사용하여 클러스터를 만들고 클러스터 수명 주기를 관리해야 할 수 있습니다.
gkectl을 사용하여 클러스터를 만들면 기본적으로 GKE On-Prem API로 등록됩니다. 클러스터가 생성된 후 클러스터를 등록하여 GKE On-Prem API 클라이언트를 사용할 수도 있습니다.
GKE On-Prem API 클라이언트 제한사항
gkectl 도구는 지원되는 기능 중 가장 성숙한 도구입니다. 선택할 때 GKE On-Prem API 클라이언트의 기능을 검토하는 것이 좋습니다. 다음 목록에는 GKE On-Prem API 클라이언트에서 지원하지 않는 기능이 나와 있습니다.
관리자 클러스터와 사용자 클러스터의 부하 분산기 종류가 같아야 합니다. 관리자 클러스터에서 Seesaw를 사용하는 경우 사용자 클러스터에서 MetalLB를 사용할 수 있다는 점만 예외입니다. 관리자 클러스터와 사용자 클러스터에서 서로 다른 종류의 부하 분산기를 사용하려면 gkectl을 사용하여 클러스터를 만들어야 합니다.
Google Cloud 콘솔을 사용하여 사용자 클러스터를 만들면 모든 vCenter 설정이 관리자 클러스터에서 상속됩니다. 사용자 클러스터의 vCenter 설정이 관리자 클러스터와 달라야 하는 경우 gcloud CLI, Terraform 또는 gkectl을 사용하여 사용자 클러스터를 만듭니다.
GKE On-Prem API 클라이언트가 계속 발전하고 있으므로 이러한 제한사항을 수시로 확인하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-01(UTC)"],[],[],null,["Google Distributed Cloud provides you a choice of tools to create clusters and\nmanage the cluster lifecycle operations (update, upgrade, and delete):\n\n- The command-line tool `gkectl`, which you run on your admin workstation in your on-premises data center. You create a [configuration file](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/user-cluster-configuration-file-latest) that describes the cluster network, load balancing, and other cluster features. You specify this file on the command line to `gkectl`.\n- The Google Cloud console, Google Cloud CLI, or [Terraform](https://www.terraform.io), which you can run from any computer that has network connectivity to the GKE On-Prem API. These standard tools use the [GKE On-Prem API](/kubernetes-engine/distributed-cloud/reference/on-prem-api-overview), which runs on Google Cloud infrastructure. Collectively, the standard tools are referred to as the *GKE On-Prem API clients*. To manage the lifecycle of your clusters, the GKE On-Prem API must store metadata about your cluster's state in Google Cloud, in the Google Cloud region that you specify when creating the cluster. This metadata lets the API manage the cluster lifecycle and doesn't include workload-specific data.\n\nNo matter which tool you use to create clusters, the information that\nyou gather and provide to the tool, such as the IP addresses\nof cluster node machines and load balancer VIPs, is the same.\n\nThis selection lets you choose the best tool for your use case and\nenvironment. For example:\n\n- For your first installations in a development environment, you might want to use the Google Cloud console because the user interface provides additional guidance and help.\n- If your organization already uses the gcloud CLI or Terraform to manage other Google Cloud resources, you will probably want to use these tools for Google Distributed Cloud as well.\n- If your organization has regulatory requirements or restrictions, you might need to limit your reliance on Google Cloud and use `gkectl` on your admin workstation to create clusters and manage cluster lifecycle.\n\nIf you create a cluster with `gkectl`, it will be enrolled with the\nGKE On-Prem API by default. You can also\n[enroll the cluster](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/enroll-cluster) after it is created,\nwhich lets you use the GKE On-Prem API clients.\n\nLimitations with the GKE On-Prem API clients\n\nThe `gkectl` tool is the most mature as far as features that it supports. We\nrecommend that you review the capabilities for the GKE On-Prem API clients when\nmaking a choice. The following list shows the features that are not supported by\nthe GKE On-Prem API clients.\n\n- [Advanced clusters](/kubernetes-engine/distributed-cloud/vmware/docs/concepts/advanced-clusters)\n- Secret management and rotation\n- Certificate rotation\n- Authentication\n- Usage metering\n- Application level logging and monitoring\n- Advanced networking\n- Windows node pools\n\nThe following list describes additional limitations with the GKE On-Prem API\nclients:\n\n- The gcloud CLI isn't supported for any admin cluster lifecycle\n operation. You can use `gkectl`, the console, the\n gcloud CLI, or Terraform to create admin clusters.\n\n- The `gkectl` command-line tool is the only tool available for upgrading,\n updating, and deleting admin clusters.\n\n- Only `gkectl` and Terraform support using a\n [private registry](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/private-registry).\n\n- The kind of load balancer for an admin cluster and its user clusters must be\n the same. The only exception is if the admin cluster uses Seesaw, then the\n user clusters can use MetalLB. If you want your admin and user clusters to use\n different kinds of load balancers, you must create the clusters using\n `gkectl`.\n\n- When you create a user cluster using the Google Cloud console, all the\n [`vCenter` settings](/kubernetes-engine/distributed-cloud/vmware/docs/how-to/user-cluster-configuration-file-latest#vcenter-section)\n are inherited from the admin cluster. If you need a user cluster to have\n different `vCenter` settings from its admin cluster, use the\n gcloud CLI, Terraform, or `gkectl` to create the user cluster.\n\nCheck on these limitations from time to time as the GKE On-Prem API clients\nevolve."]]