Google Distributed Cloud 에어 갭은 Google Kubernetes Engine (GKE) Enterprise 버전을 통해 관리형 Kubernetes 서비스를 제공하므로 업계 표준 Kubernetes 방법론을 사용하여 컨테이너 워크로드를 배포하고 실행할 수 있습니다. GDC Sandbox 인스턴스에는 다음과 같은 세 개의 클러스터가 생성되어 있습니다.
인스턴스의 컨트롤 플레인 역할을 하는 조직 인프라 클러스터
컨테이너 워크로드를 실행하기 위한 두 개의 Kubernetes 클러스터
에어 갭이 적용된 Google Distributed Cloud 클러스터에 관한 자세한 내용은 클러스터 아키텍처를 참고하세요.
조직 인프라 클러스터
GDC Sandbox는 org-1-admin라는 조직 인프라 클러스터를 제공합니다. 조직 인프라는 조직의 컨트롤 플레인 및 데이터 플레인 구성요소를 실행합니다. 또한 모든 비컨테이너 워크로드와 서비스가 배포되는 관리 API 서버를 호스팅합니다. 예를 들어 관리 API 서버를 사용하여 VM을 실행하고 제어합니다.
명령줄에서 Management API 서버를 사용하려면 다음을 실행하세요.
연결에 설명된 대로 gdcloud 명령어를 사용하여 다운로드, 구성, 인증을 완료했는지 확인합니다.
KUBECONFIG 환경 변수를 설정하고 관리 API 서버의 kubeconfig 파일을 다운로드합니다.
GDC 샌드박스 인스턴스에는 org-1 조직에 user-vm-1 및 user-vm-2라는 사전 생성된 Kubernetes 클러스터가 두 개 있습니다. 컨테이너 기반 워크로드에 이러한 클러스터를 사용합니다.
Kubernetes 클러스터는 Distributed Cloud에서 사용자 클러스터라고도 합니다.
[[["이해하기 쉬움","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-04(UTC)"],[],[],null,["# Work with clusters\n\nGoogle Distributed Cloud air-gapped provides a managed Kubernetes service with\n[Google Kubernetes Engine (GKE) Enterprise edition](/kubernetes-engine/docs/concepts/gke-editions#why),\nletting you deploy and run container workloads using industry standard\nKubernetes methodologies. Your GDC Sandbox instance comes with three\nclusters created for you:\n\n- An *org infrastructure cluster*, which serves as the control plane for your instance, and\n- Two *Kubernetes clusters* for running your container workloads.\n\nFor details on Google Distributed Cloud air-gapped clusters, see\n[Cluster architecture](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/clusters#cluster-architecture).\n\nThe org infrastructure cluster\n------------------------------\n\nGDC Sandbox provides you an org infrastructure cluster called\n`org-1-admin`. The org infrastructure runs the control plane and data plane\ncomponents of the organization. It also hosts the Management API server where\nall non-container workloads and services are deployed. For example, you would\nuse the Management API server to launch and control VMs.\n\nTo work with the Management API server on the command line, do the following:\n\n1. Make sure that you have downloaded, configured, and authenticated with\n the `gdcloud` command as described in [Connect](/distributed-cloud/sandbox/latest/gdcloud).\n\n2. Set a `KUBECONFIG` environment variable and download a kubeconfig file\n for the Management API server:\n\n export KUBECONFIG=org-1-admin-kubeconfig\n gdcloud clusters get-credentials org-1-admin\n\nIn a similar way, to work with the `org-infra` cluster, do the following:\n\n1. Set a `KUBECONFIG` environment variable and download a kubeconfig file\n for the Management API server:\n\n export KUBECONFIG=org-1-infra-kubeconfig\n gdcloud clusters get-credentials org-1-infra\n\nKubernetes clusters\n-------------------\n\nYour GDC Sandbox instance comes with two pre-created Kubernetes clusters,\ncalled `user-vm-1` and `user-vm-2`, in the\n`org-1` organization. Use these clusters for container-based workloads.\nA Kubernetes cluster is sometimes referred to as a *user cluster*\nin Distributed Cloud.\n| **Warning:** Don't attempt to create new Kubernetes clusters. GDC Sandbox doesn't support additional clusters.\n\nYou can attach clusters to a project when you\n[create a project](/distributed-cloud/sandbox/latest/create-project).\n\nTo work with Kubernetes clusters on the command line, do the following:\n\n1. Make sure that you have downloaded, configured, and authenticated with\n the `gdcloud` command as described in [Connect](/distributed-cloud/sandbox/latest/gdcloud).\n\n2. Set a `KUBECONFIG` environment variable and download a kubeconfig file\n for the cluster you want to use, either `user-vm-1` or `user-vm-2`.\n The following example downloads a kubeconfig for `user-vm-1`:\n\n export KUBECONFIG=user-vm-1-kubeconfig\n gdcloud clusters get-credentials user-vm-1 --zone zone1"]]
