La API de clúster usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes (KRM). Gestiona el ciclo de vida de los clústeres de una organización determinada, como la instalación, la actualización y la desinstalación.
Para usar la API de clústeres, te recomendamos que uses la consola de GDC. Si tu aplicación necesita usar sus propias bibliotecas para llamar a esta API, utiliza el siguiente ejemplo y la definición completa de la API para crear tus solicitudes.
Punto de conexión de servicio y documento de descubrimiento
El endpoint de la API Cluster es https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.gdc.goog/v1, donde MANAGEMENT_API_SERVER_ENDPOINT es el endpoint del servidor de la API Management.
Con el comando kubectl proxy, puedes acceder a esa URL en tu navegador o con una herramienta como curl para obtener el documento de descubrimiento de la API Cluster.
El comando kubectl proxy abre un proxy al servidor de la API de Kubernetes en tu máquina local. Una vez que se haya ejecutado el comando, podrás acceder al documento en la siguiente URL: http://127.0.0.1:8001/apis/cluster.gdc.goog/v1.
Recurso de clúster de ejemplo
A continuación, se muestra un ejemplo de un objeto Cluster configurado como un clúster de usuarios:
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