Descripción general de la API de Cluster

La API de clústeres usa recursos personalizados de Kubernetes y se basa en el modelo de recursos de Kubernetes (KRM). Administra el ciclo de vida de los clústeres en 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 tus propias bibliotecas para llamar a esta API, usa el siguiente ejemplo y la definición completa de la API para compilar tus solicitudes.

Extremo de servicio y documento de descubrimiento

El extremo de API para la API de clústeres es https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.gdc.goog/v1, en el que MANAGEMENT_API_SERVER_ENDPOINT es el endpoint de API del servidor de la API de 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 ejecuta 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