Configurer kubectl sur un cluster OVHcloud Managed Kubernetes

Objectif

OVHcloud Managed Kubernetes Service vous donne accès à des clusters Kubernetes sans que vous ayez à vous soucier de leur installation ou de leur exploitation.

Ce guide explique comment récupérer le fichier de configuration kubectl pour interagir avec un cluster OVHcloud Managed Kubernetes.

Prérequis

• Un projet Public Cloud dans votre compte OVHcloud.
• Vous devez disposer d'un cluster OVHcloud Managed Kubernetes.
• Vous devez avoir installé l'outil de ligne de commande kubectl.

Vous trouverez les instructions d'installation détaillées de kubectl dans la documentation officielle de Kubernetes.

Accès à l'espace client OVHcloud

• Lien direct : Tous mes projets Public Cloud
• Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Managed Kubernetes Service

En pratique

Étape 1 - Configurer les paramètres par défaut de kubectl

Cliquez sur le nom de votre cluster pour ouvrir sa page de détails.

Dans l'onglet Overview du cluster, cliquez sur kubeconfig pour télécharger le fichier de configuration kubectl.

Comment les fichiers kubeconfig sont-ils chargés ?

• 1. depuis le flag --kubeconfig, s'il est spécifié
• 2. depuis la variable d'environnement KUBECONFIG, si elle est définie
• 3. depuis le fichier $HOME/.kube/config, par défaut

Ainsi, après l'avoir téléchargé, si vous souhaitez utiliser ce fichier de configuration par défaut dans kubectl, vous pouvez l'enregistrer sous le nom config dans le répertoire $HOME/.kube/. Vous pouvez également le placer dans votre répertoire de travail, en utilisant la variable d'environnement KUBECONFIG ou le flag --kubeconfig.

Dans cet exemple, nous utilisons la méthode de la variable d'environnement KUBECONFIG.

Pour macOS ou Linux :

Saisissez la commande suivante dans votre terminal :

export KUBECONFIG=/Users/myuser/.kube/my-test-cluster.yml

Pour Windows 7, 10 et 11 :

1. Dans le menu Windows ou la barre de recherche Cortana, recherchez « Modifier les variables d'environnement système ».
2. Dans la fenêtre Propriétés système, cliquez sur l'onglet Avancé, puis sur le bouton Variables d'environnement en bas de la fenêtre.
3. Dans la fenêtre qui s'ouvre, ajoutez une nouvelle variable, KUBECONFIG, avec le chemin du fichier kube-config comme valeur.

Vous pouvez également ajouter la variable pour le processus shell actuel avec cette commande :

set KUBECONFIG=my-test-cluster.yml

Étape 2 - Vérifier que kubectl peut se connecter au cluster

Vous pouvez vérifier que kubectl est capable d'interagir avec le cluster en l'utilisant pour envoyer une commande cluster-info :

kubectl cluster-info

Le cluster doit renvoyer une réponse contenant quelques informations clés sur lui-même :

$ kubectl cluster-info
Kubernetes control plane is running at https://xxxxxx.c2.gra.k8s.ovh.net
CoreDNS is running at https://xxxxxx.c2.gra.k8s.ovh.net/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy
Metrics-server is running at https://xxxxxx.c2.gra.k8s.ovh.net/api/v1/namespaces/kube-system/services/https:metrics-server:/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

Définir l'accès pour plusieurs clusters Kubernetes

Vous pouvez également spécifier plusieurs fichiers kubeconfig dans votre variable d'environnement KUBECONFIG, séparés par un signe deux-points (:).

export KUBECONFIG=/Users/myuser/.kube/my-test-cluster.yml:/Users/myuser/.kube/my-test-cluster2.yml

Basculer vers un autre cluster

Vous pouvez basculer entre différents clusters à l'aide de la commande kubectl config.

$ kubectl config use-context kubernetes-admin@my-test-cluster
Switched to context "kubernetes-admin@my-test-cluster".

$ kubectl config use-context kubernetes-admin@my-test-cluster2
Switched to context "kubernetes-admin@my-test-cluster2".

Vous pouvez également installer et utiliser kubectx.

Aller plus loin

Pour déployer votre première application sur votre cluster Kubernetes, nous vous invitons à consulter notre guide Déployer une application.

• Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

• Échangez avec notre communauté d'utilisateurs.