叢集 API 會使用 Kubernetes 自訂資源,並依賴 Kubernetes 資源模型 (KRM)。可管理特定機構中的叢集生命週期,例如安裝、升級及解除安裝。
如要使用 Cluster API,建議使用 GDC 控制台。如果您的應用程式需要使用自己的程式庫呼叫這項 API,請使用下列範例和完整 API 定義來建構要求。
服務端點和探索文件
Cluster API 的 API 端點為 https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.gdc.goog/v1
,其中 MANAGEMENT_API_SERVER_ENDPOINT
是 Management API 伺服器的端點。
使用 kubectl proxy
指令,您可以在瀏覽器中存取該網址,或使用 curl
等工具取得 Cluster API 的探索文件。kubectl proxy
指令會在您的本機電腦上開啟 Kubernetes API 伺服器的 Proxy。執行該指令後,您就能透過下列網址存取文件:http://127.0.0.1:8001/apis/cluster.gdc.goog/v1
。
叢集資源範例
以下範例顯示設定為使用者叢集的 Cluster
物件:
apiVersion: cluster.gdc.goog/v1
kind: Cluster
metadata:
name: user-vm-1
namespace: platform
spec:
clusterNetwork:
podCIDRSize: 21
serviceCIDRSize: 23
initialVersion:
kubernetesVersion: 1.27.1-gke.700
loadBalancer:
ingressServiceIPSize: 21
nodePools:
- machineTypeName: n2-standard-8-gdc
name: worker-node-pool
nodeCount: 3
releaseChannel:
channel: UNSPECIFIED