Cluster API 總覽

叢集 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