Récupérer le fichier de configuration d'un cluster

Une fois la création du cluster effectuée, pour accéder aux diverses fonctionnalités du cluster via l'outil en ligne de commande kubectl, il est nécessaire de se procurer au préalable le fichier de configuration du cluster. Le fichier de configuration du cluster permettra à l'outil en ligne de commande kubectl de localiser et d'authentifier les commandes saisies par l'utilisateur via la variable d'environnement KUBECONFIG.

info

L'accès au cluster doit se faire via un Bastion, dont la clé privée doit être récupérée pour mettre en place du Port Forwarding

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.

Vous arriverez sur la page de détails du cluster Kubernetes sélectionné. Pour télécharger le fichier de configuration du cluster (KubeConfig), cliquez sur le bouton Télécharger la KubeConfig.

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 des accès RBAC qui accordent les droits nécessaires à la lecture au cluster ciblé.
• Un jeton de connexion associé au compte NumSpot utilisé.

Comment récupérer le fichier de configuration d'un cluster

Les données qu'il faut avoir

• CLUSTER_ID est l'identifiant du cluster créé 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 récupération du fichier de configuration d'un cluster

Exemple de requête: Récupérer le fichier de configuration 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/de configuration \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json"

Exemple de réponse: Récupérer le fichier de configuration d'un cluster

apiVersion: v1
kind: Config
clusters:
  - name: 5953ed12-062e-4f16-a49f-7ca242f00c18
    cluster:
      certificate-authority-data: ...

note

Pour la procédure complète de connection à la Kube API voir la section dédie dans le démarrage rapide