Aller au contenu principal

Consulter l'état d'un cluster

Une fois un cluster Kubernetes créé, il est possible de consulter l'état en temps réel du cluster et donc de ses nœuds. L'état des nœuds indique la consommation de leurs ressources et précise s'ils sont prêt à être utilisés.

attention

Pour accéder à la fonctionnalité permettant de récupérer l'état du cluster, le status du cluster doit être à ACTIVE (voir comment consulter les informations d'un cluster). Autrement cela pourrait générer un conflit car les dépendances ne seront pas toutes disponibles durant de la création.

Prérequis​

  • Un compte NumSpot
  • Un espace NumSpot auquel le compte est associé
  • Un compte avec le rôle Kubernetes Admin sur l'espace
  • Un jeton de connexion associé au compte NumSpot utilisé
  • Un cluster correctement créé

Comment consulter l'état d'un cluster​

Les données qu'il faut avoir​

  • CLUSTER_ID est l'identifiant du cluster créé dans dans l'espace NumSpot, et n'est disponible que depuis cet espace.
  • SPACE_ID est l'identifiant de l'espace NumSpot dans lequel il est souhaité de créer le cluster
  • REGION est la région dans laquelle l'espace NumSpot est associé, un espace est disponible qu'à partir d'une seule région
  • ACCESS_TOKEN est le jeton (token) généré via la connexion (consulter la génération d'un token d'accès)

Requête de création d'un cluster​

Exemple de requête: Consulter l'état d'un cluster
export CLUSTER_ID="myclusterid"
export REGION="myregion"
export SPACE_ID="myspaceid"
export ACCESS_TOKEN="myaccesstoken"

curl -X GET https://api.$REGION.numspot.com/kubernetes/spaces/$SPACE_ID/clusters/$CLUSTER_ID/state \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json"
Exemple de réponse: Consulter l'état d'un cluster
{
  "clusterId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "spaceId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "name": "clusterName",
  "health": "OK",
  "nodes": [
    {
      "name": "worker1",
      "status": "OK",
      "cpu": {
        "used": "0",
        "available": "2"
      },
      "memory": {
        "used": "102m",
        "available": "360m"
      }
    }
  ]
}

Si le cluster n'est pas en mesure de répondre aux requêtes effectuées par le service Kubernetes, le statut du cluster sera considéré comme KO dans le champ health.

Le champs status peut prendre deux valeurs:

  • OK indique que le nœud est dans un état complètement exploitable
  • FAILED indique que la nœud est non exploitable

Un cluster en cours de suppression sera toujours visible tant que l'opération de suppression n'est pas arrivée à son terme.