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 Cluster, 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 la API de Cluster es https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.gdc.goog/v1, donde MANAGEMENT_API_SERVER_ENDPOINT es el extremo 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 Cluster. El comando kubectl proxy abre un proxy al servidor de la API de Kubernetes en tu máquina local. Una vez que se ejecute ese comando, podrás 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