Récupérer les informations d'un cluster
Un cluster peut être consulté dès lors qu'une demande de création de cluster est effectuée (même si le cluster n'est qu'en cours de création).
Il en est de même lors de la suppression, tant que le cluster n'est pas réellement supprimé (consulter le status de l'opération) suite à une suppression de cluster, il est toujours possible de consulter ses informations.
- Console
- API
Prérequis
- Un compte NumSpot.
- Un espace NumSpot auquel le compte est associé.
- Un compte avec le rôle Kubernetes Viewer ou Kubernetes Admin sur l'espace ou les accès RBAC qui octroient le droit de lecture du cluster ciblé.
- Un jeton de connexion associé au compte NumSpot utilisé.
Comment récupérer les informations 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 a été créé.ACCESS_TOKEN
est le jeton (token) généré via la connexion (consulter la génération d'un token d'accès).
export REGION="myregion"
export SPACE_ID="myspaceid"
export CLUSTER_ID="myclusterid"
export ACCESS_TOKEN="myaccesstoken"
curl -X GET https://api.$REGION.numspot.com/kubernetes/spaces/$SPACE_ID/clusters/$CLUSTER_ID \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header 'Content-Type: application/json'
{
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"spaceId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"status": "ACTIVE",
"operationId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"clientBastionPublicIP": "X.X.X.X",
"name": "myCluster",
"selfLink": "string",
"version": "1.29.5",
"cidr": "10.1.0.0/16",
"nodePools": [
{
"name": "standard",
"kubernetesVersion": "1.29.5",
"nodeCount": 2,
"nodeProfile": {
"cpu": 4,
"memory": 8,
"name": "small"
}
},
{
"kubernetesVersion": "1.29.5",
"name": "gpu",
"gpuType": "A100-80",
"nodeCount": 1,
"nodeProfile": {
"cpu": 8,
"memory": 16,
"name": "mediumgpu"
}
}
],
"urls": [
{
"ingress": "lbi-XXXXXXXXXXXX-XXXXXXXXX.myregion.lbu.outscale.com",
"api": "internal-lbm-XXXXXXXXXXXX-XXXXXXXXX.myregion.lbu.outscale.com"
}
],
"createdAt": "2024-08-19T14:04:43.765Z",
"updatedAt": "2024-08-19T14:04:43.765Z"
}
Le status du cluster
Le champ status
fait référence à l'état d'exploitation du cluster.
Dans l'exemple ci-dessus, il est ACTIVE
ce qui indique que le cluster est prêt à être utilisé.
L'état d'exploitation du cluster est modifié par les opérations. Si une opération crucial échoue (comme la création du cluter), le status pourrait se retrouver à ERROR
ou FAILED
, indiquant que le cluster, si utilisé, ne garanti pas le bon fonctionnement voire n'est plus utilisable.
(Plus d'information sur le cycle de vie d'un cluster)
Dernière opération
Le champ operationId
indique la dernière opération demandée sur le cluster, peu importe l'état de cette l'opération.
Si le cluster est en état altéré, il est possible de retracer la dernière opération pour déboguer et corriger l'échec.
Accéder à Kubernetes
Lorsque la demande de création est effectuée et que celle-ci se termine avec succès, une URL supplémentaire est fournie parmi les informations du cluster. Cette URL permet d'accéder à l'interface Kubernetes via NumSpot pour la gestion du cluster. Il existe 2 méthodes pour se connecter au cluster Kubernetes :
- L'API exposée de Kubernetes : un client HTTP que vous pouvez utiliser avec
curl
,wget
ou autre client HTTP ; - Le CLI: un outil en ligne de commande nommé
kubectl
qui interagit avec la Kube-API de Kubernetes. Il est possible de récupérer le binaire depuis la console Kubernetes : Installing the Kubernetes CLI
C'est par le biais de cette interface Kubernetes via NumSpot que vous pourrez possible de gérer votre cluster Kubernetes, et ses ressources.