Panoramica dell'API Cluster

L'API Cluster utilizza risorse personalizzate Kubernetes e si basa sul modello di risorse Kubernetes (KRM). Gestisce il ciclo di vita dei cluster in una determinata organizzazione, ad esempio installazione, upgrade e disinstallazione.

Per utilizzare l'API Cluster, ti consigliamo di utilizzare la console GDC. Se la tua applicazione deve utilizzare le tue librerie per chiamare questa API, utilizza l'esempio seguente e la definizione completa dell'API per creare le tue richieste.

Endpoint di servizio e documento di rilevamento

L'endpoint API per l'API Cluster è https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.gdc.goog/v1, dove MANAGEMENT_API_SERVER_ENDPOINT è l'endpoint del server API di gestione.

Utilizzando il comando kubectl proxy, puoi accedere a questo URL nel browser o con uno strumento come curl per ottenere il documento di rilevamento per l'API Cluster. Il comando kubectl proxy apre un proxy al server API Kubernetes sulla tua macchina locale. Una volta eseguito il comando, puoi accedere al documento all'URL http://127.0.0.1:8001/apis/cluster.gdc.goog/v1.

Risorsa cluster di esempio

Di seguito è riportato un esempio di oggetto Cluster configurato come cluster di utenti:

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