Présentation de l'API Cluster

L'API Cluster utilise des ressources personnalisées Kubernetes et s'appuie sur le modèle de ressource Kubernetes (KRM). Il gère le cycle de vie des clusters dans une organisation donnée, comme l'installation, la mise à niveau et la désinstallation.

Pour utiliser l'API Cluster, nous vous recommandons d'utiliser la console GDC. Si votre application doit utiliser vos propres bibliothèques pour appeler cette API, utilisez l'exemple suivant et la définition complète de l'API pour créer vos requêtes.

Point de terminaison du service et document de découverte

Le point de terminaison de l'API pour l'API Cluster est https://MANAGEMENT_API_SERVER_ENDPOINT/apis/cluster.gdc.goog/v1, où MANAGEMENT_API_SERVER_ENDPOINT est le point de terminaison du serveur de l'API Management.

À l'aide de la commande kubectl proxy, vous pouvez accéder à cette URL dans votre navigateur ou avec un outil tel que curl pour obtenir le document de découverte de l'API Cluster. La commande kubectl proxy ouvre un proxy vers le serveur d'API Kubernetes sur votre machine locale. Une fois cette commande exécutée, vous pouvez accéder au document à l'URL suivante : http://127.0.0.1:8001/apis/cluster.gdc.goog/v1.

Exemple de ressource Cluster

Voici un exemple d'objet Cluster configuré en tant que cluster d'utilisateur :

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