La API de clústeres 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 API de clústeres es
https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.gdc.goog/v1,
donde MANAGEMENT_API_SERVER_ENDPOINT es el endpoint 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 de clústeres.
El comando kubectl proxy abre un proxy al servidor de la API de Kubernetes en tu máquina local. Una vez que se esté ejecutando ese comando, puedes acceder al documento en la siguiente URL: http://127.0.0.1:8001/apis/cluster.gdc.goog/v1.
Ejemplo de recurso de clúster
A continuación, se muestra un ejemplo de un objeto Cluster configurado como un clúster de usuario:
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