Ajouter des nœuds

La plateforme Kubernetes managé de NumSpot manipule directement les nœuds d'un cluster. Les nœuds sont rassemblés à partir de leurs caractéristiques.

Concurrence des opérations

L'ajout de nœuds dans un cluster rentre dans les actions qui impactent techniquement le cluster.
Cette action peut être lancée seulement si le cluster en question n'a pas d'autre opération en cours. Pour rappel, toute opération constitue une demande qui a un impacte technique sur le cluster. Voici la liste des opérations:

• Ajouter des workers
• Supprimer des workers
• Mettre à jour les paquets OS des workers
• Mettre à niveau les workers
• Mettre à niveau le planel de contrôle
• Créer un cluster
• Supprimer un cluster

Console

Depuis la page Services Managés > Kubernetes qui affiche la liste de vos clusters, cliquez sur l'UUID d'un cluster pour afficher les détails de ce dernier.

Dans la section Workers du cluster Kubernetes, cliquez sur le bouton Ajouter des workers.

Sur le formulaire d'ajout de workers, vous devez choisir le nombre de nouveaux workers à ajouter au cluster. Vous ne pouvez pour le moment choisir un profil de workers similaire à celui actuellement utilisé par le cluster. Appuyer sur Ajouter le(s) workers pour confirmer.

API

Prérequis

• Un compte NumSpot.
• Un espace NumSpot auquel le compte est associé.
• Un compte avec le rôle Kubernetes Admin sur l'espace ou les accès RBAC qui octroient le droit d'ajouter des workers dans le cluster ciblé.
• Un jeton de connexion associé au compte NumSpot utilisé.

Ajouter des workers

Profil des workers à ajouter

Le profil des workers permet de spécifier les caractéristiques techniques des workers à ajouter au cluster. Pour simplifier son utilisation, il existe 6 profils de worker:

• verysmall
• small
• medium
• medium_gpu
• large
• verylarge

Chacun de ces profils a caractéristiques techniques fixes, indépendamment de la région dans laquelle le cluster ciblé est créé.

info

Le medium_gpu est un profil étendu de medium qui est accordé à un GPU Nvidia.

Pour plus de précision, consulter les GPUs disponibles.

Les données qu'il faut avoir

• SPACE_ID est l'identifiant de l'espace NumSpot dans lequel le cluster a été créé
• 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)
• CLUSTER_ID est l'identifiant du cluster NumSpot sur lequel on veut effectuer la mise à jour

Requête d'ajout de workers

Exemple de requête: Ajout de **workers** dans un cluster Kubernetes

export REGION="myregion"
export SPACE_ID="myspaceid"
export ACCESS_TOKEN="myaccesstoken"
export CLUSTER_ID="myclusterid"

curl -X POST https://api.$REGION.numspot.com/kubernetes/spaces/$SPACE_ID/clusters/$CLUSTER_ID/workers/add \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header 'Content-Type: application/json' \
  --data '{
    "nodeCount": 3,
    "nodeProfile": "small"
}'

Si l'opération lancée est validée et acceptée, un objet Operation est retourné par l'API avec un code de statut 202 Accepted:

Exemple de réponse: Ajout de **workers** dans un cluster Kubernetes

{
  "id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "operationType": "AddWorker",
  "status": "PENDING",
  "progress": "During step",
  "target": "https://..../kubernetes/spaces/{spaceId}/clusters/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "selfLink": "https://..../kubernetes/spaces/{spaceId}/operations/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "targetName": "myCluster",
  "clusterid": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    ...
}