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