Cluster API 概览

Cluster 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 是管理 API 服务器的端点。

使用 kubectl proxy 命令,您可以在浏览器中或使用 curl 等工具访问该网址,以获取 Cluster API 的发现文档。kubectl proxy 命令会在本地机器上打开一个指向 Kubernetes API 服务器的代理。该命令运行后,您可以通过以下网址访问文档: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