Cluster API는 Kubernetes 커스텀 리소스를 사용하고 Kubernetes 리소스 모델 (KRM)을 사용합니다. 설치, 업그레이드, 제거와 같은 지정된 조직의 클러스터 수명 주기를 관리합니다.
클러스터 API를 사용하려면 GDC 콘솔을 사용하는 것이 좋습니다. 애플리케이션에서 자체 라이브러리를 사용하여 이 API를 호출해야 한다면 다음 예시와 전체 API 정의를 사용하여 요청을 빌드하세요.
서비스 엔드포인트 및 검색 문서
클러스터 API의 API 엔드포인트는 다음과 같습니다.
https://GDCH_API_SERVER_ENDPOINT/apis/cluster.gdc.goog/v1
여기서 GDCH_API_SERVER_ENDPOINT은 GDC API 서버의 API 엔드포인트입니다.
kubectl proxy 명령어를 사용하여 브라우저에서 또는 curl과 같은 도구로 해당 URL에 액세스하여 클러스터 API의 검색 문서를 가져올 수 있습니다.
kubectl proxy 명령어를 사용하면 로컬 머신에서 Kubernetes API 서버로의 프록시가 열립니다. 명령어가 실행되면 http://127.0.0.1:8001/apis/cluster.gdc.goog/v1 URL에서 문서에 액세스할 수 있습니다.
[[["이해하기 쉬움","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)"],[[["\u003cp\u003eThe Cluster API, leveraging Kubernetes custom resources and the Kubernetes Resource Model (KRM), is used to manage cluster lifecycles, including installation, upgrades, and uninstallation.\u003c/p\u003e\n"],["\u003cp\u003eThe recommended method for interacting with the Cluster API is through the GDC console, but custom libraries can be used by referencing the provided API definition and examples.\u003c/p\u003e\n"],["\u003cp\u003eThe Cluster API endpoint is located at \u003ccode\u003ehttps://<GDCH_API_SERVER_ENDPOINT>/apis/cluster.gdc.goog/v1\u003c/code\u003e, where \u003ccode\u003e<GDCH_API_SERVER_ENDPOINT>\u003c/code\u003e represents the GDC API server's endpoint.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the \u003ccode\u003ekubectl proxy\u003c/code\u003e command to access the Cluster API's discovery document at \u003ccode\u003ehttp://127.0.0.1:8001/apis/cluster.gdc.goog/v1\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAn example \u003ccode\u003eCluster\u003c/code\u003e resource is provided, showcasing configuration details like network settings, Kubernetes version, load balancer, node pools and release channel.\u003c/p\u003e\n"]]],[],null,["# Cluster API overview\n\nThe Cluster API uses Kubernetes custom resources and relies on the Kubernetes\nResource Model (KRM). It manages the lifecycle of clusters in a given\norganization, such as installing, upgrading, and uninstalling.\n\nTo use the Cluster API, we recommend that you use the GDC console. If\nyour application needs to use your own libraries to call this API, use the\nfollowing example and the [full API definition](/distributed-cloud/hosted/docs/latest/appliance/apis/service/cluster/cluster-krm-api) to build your\nrequests.\n\nService endpoint and discovery document\n---------------------------------------\n\nThe API endpoint for the Cluster API is:\n`https://`\u003cvar translate=\"no\"\u003eGDCH_API_SERVER_ENDPOINT\u003c/var\u003e`/apis/cluster.gdc.goog/v1`\nwhere \u003cvar translate=\"no\"\u003eGDCH_API_SERVER_ENDPOINT\u003c/var\u003e is the API endpoint of the\nGDC API server.\n\nUsing the `kubectl proxy` command, you can access that URL in your browser or\nwith a tool such as `curl` to get the discovery document for the Cluster API.\nThe `kubectl proxy` command opens up a proxy to the Kubernetes API server on\nyour local machine. Once that command is running, you can access the document at\nthe following URL: `http://127.0.0.1:8001/apis/cluster.gdc.goog/v1`.\n\nExample Cluster resource\n------------------------\n\nThe following is an example of a `Cluster` object configured as a user cluster: \n\n apiVersion: cluster.gdc.goog/v1\n kind: Cluster\n metadata:\n name: user-vm-1\n namespace: platform\n spec:\n clusterNetwork:\n podCIDRSize: 21\n serviceCIDRSize: 23\n initialVersion:\n kubernetesVersion: 1.27.1-gke.700\n loadBalancer:\n ingressServiceIPSize: 21\n nodePools:\n - machineTypeName: n2-standard-8-gdc\n name: worker-node-pool\n nodeCount: 3\n releaseChannel:\n channel: UNSPECIFIED"]]
