Comment installer MicroK8s sur Ubuntu 26.04

MicroK8s est une distribution Kubernetes légère et de qualité production développée par Canonical qui s'exécute entièrement en tant que paquet snap. Que vous exploriez l'orchestration de conteneurs ou configuriez un cluster de développement local, une installation de k8s sur Ubuntu 26.04 avec MicroK8s est l'une des voies les plus rapides vers un environnement Kubernetes pleinement fonctionnel. Ce guide vous accompagne à chaque étape, de l'installation et de la configuration du groupe à l'activation des add-ons principaux et à la vérification de votre cluster.

Dans ce tutoriel, vous apprendrez :

• Comment installer MicroK8s sur Ubuntu 26.04 en utilisant snap
• Comment configurer les autorisations des groupes d'utilisateurs pour l'accès kubectl
• Comment vérifier que le cluster MicroK8s fonctionne correctement
• Comment activer les modules complémentaires essentiels tels que le stockage, le tableau de bord, l'ingress et le registre
• Comment créer un alias kubectl pour une gestion simplifiée des clusters
• Comment démarrer, arrêter et vérifier l'état de MicroK8s

Exigences Logiciel

Résumé de l'article : Pour effectuer une installation de k8s sur Ubuntu 26.04, installez MicroK8s via snap, ajoutez votre utilisateur au groupe microk8s, puis vérifiez l'état du cluster.

sudo snap install microk8s --classic

sudo usermod -aG microk8s $USER && newgrp microk8s

microk8s status --wait-ready

microk8s kubectl get nodes

Installer MicroK8s sur Ubuntu 26.04

MicroK8s est distribué exclusivement sous forme de paquet snap, et puisque snapd est préinstallé sur Ubuntu 26.04, vous pouvez commencer l'installation de k8s sur Ubuntu 26.04 immédiatement sans aucune préparation supplémentaire. Le drapeau --classic accorde à MicroK8s l'accès au système dont il a besoin pour gérer les conteneurs et le réseau.

Installez MicroK8s avec la commande suivante :

$ sudo snap install microk8s --classic

Snap téléchargera et installera la dernière version stable de MicroK8s. Le processus prend généralement une minute ou deux en fonction de la vitesse de votre connexion. Une fois la commande terminée, le service MicroK8s démarre automatiquement en arrière-plan.

Pour installer une version spécifique de Kubernetes au lieu de la dernière version stable, vous pouvez utiliser un indicateur de canal :

$ sudo snap install microk8s --classic --channel=1.33/stable

Ceci est utile dans les environnements nécessitant une version de Kubernetes fixée pour des raisons de compatibilité. Vous pouvez parcourir les canaux disponibles sur la page du snap MicroK8s.

Configurer l'accès du groupe d'utilisateurs

Après l'installation, votre compte utilisateur n'a pas encore la permission d'interagir avec MicroK8s sans sudo. Pour corriger cela, ajoutez votre utilisateur au groupe microk8s :

$ sudo usermod -aG microk8s $USER

De plus, assurez-vous que votre utilisateur possède le répertoire ~/.kube s'il existe :

$ mkdir -p ~/.kube
$ sudo chown -R $USER ~/.kube

Pour que l'appartenance au groupe prenne effet dans votre session shell actuelle, utilisez newgrp :

$ newgrp microk8s

Alternativement, vous pouvez vous déconnecter et vous reconnecter pour appliquer le changement de groupe dans tout le système sur toutes les sessions.

Vérifier le cluster

Avec l'accès de groupe configuré, vous pouvez maintenant vérifier que l'installation de k8s sur Ubuntu 26.04 s'est terminée avec succès. Tout d'abord, attendez que MicroK8s termine son initialisation interne :

$ microk8s status --wait-ready

Cette commande se bloque jusqu'à ce que MicroK8s signale que le cluster est prêt. Vous verrez une sortie listant l'état actuel et les modules complémentaires activés ou désactivés. Un cluster sain signale microk8s is running.

Ensuite, confirmez que le nœud est visible et en état Prêt :

$ microk8s kubectl get nodes

Sortie attendue :

NAME       STATUS   ROLES    AGE   VERSION
hostname   Ready    <none>   2m    v1.35.x

Vous pouvez également inspecter tous les pods système en cours d'exécution pour confirmer que les composants principaux de Kubernetes fonctionnent :

$ microk8s kubectl get pods -A

Activer les modules complémentaires principaux

MicroK8s est livré avec une bibliothèque de modules complémentaires qui étendent les fonctionnalités du cluster. Plusieurs sont activés par défaut immédiatement après l'installation. Vous pouvez le vérifier à tout moment en exécutant :

$ microk8s status

Les modules complémentaires suivants sont activés par défaut lors d'une installation fraîche de MicroK8s :

Les modules complémentaires ci-dessous ne sont pas activés par défaut et sont généralement nécessaires pour la plupart des charges de travail. Activez-les selon les besoins :

1. Activer le stockage hostpath : Ce module complémentaire fournit une StorageClass par défaut basée sur le système de fichiers hôte, ce qui est suffisant pour le développement et les déploiements à nœud unique :

   $ microk8s enable hostpath-storage

   Après activation, une StorageClass nommée microk8s-hostpath devient disponible pour les demandes de PersistentVolumeClaim.

   AVERTISSEMENT
   Le stockage Hostpath n'est pas adapté aux environnements de production. Un volume hostpath peut dépasser la limite de taille définie dans le manifeste de la demande de volume. Utilisez un fournisseur de stockage approprié pour les charges de travail en production.

2. Activer le tableau de bord Kubernetes : Pour une vue d'ensemble du cluster via un navigateur, activez le module complémentaire du tableau de bord. Notez que l'activation du tableau de bord active également automatiquement le metrics-server s'il n'est pas déjà actif :

   $ microk8s enable dashboard

   IMPORTANT
   La commande pratique microk8s dashboard-proxy ne fonctionne actuellement pas en raison d'une URL de dépôt de chart Helm cassée dans le snap inclus. Pour accéder au tableau de bord, utilisez microk8s kubectl proxy et naviguez manuellement vers l'URL du tableau de bord.

3. Activer l’ingress : Le module complémentaire ingress déploie un contrôleur ingress NGINX, qui est nécessaire pour acheminer le trafic HTTP et HTTPS externe vers les services exécutés à l’intérieur du cluster :

   $ microk8s enable ingress

   Après l'activation, vous pouvez définir des ressources Ingress dans vos manifests pour exposer les services à l'extérieur.

4. Activer le registre privé : L'extension de registre démarre un registre privé d'images de conteneur accessible à localhost:32000. Cela est particulièrement utile dans les flux de travail de développement pour éviter des téléchargements répétés depuis Docker Hub :

   $ microk8s enable registry

   Une fois activé, taguez et poussez des images vers localhost:32000/your-image:tag et référencez-les directement dans vos manifestes de pod.

   

Configurer un alias kubectl

MicroK8s fournit son propre kubectl intégré sous la forme de microk8s kubectl. Taper ce préfixe pour chaque commande est verbeux, donc créer un alias de shell simplifie la gestion quotidienne du cluster. Ajoutez l'alias à votre fichier de configuration de shell :

$ echo "alias kubectl='microk8s kubectl'" >> ~/.bashrc
$ source ~/.bashrc

Si vous utilisez Zsh, ciblez plutôt ~/.zshrc. Après avoir chargé le fichier, vous pouvez exécuter directement les commandes kubectl standard :

$ kubectl get nodes
$ kubectl get pods -A

Gérer le service MicroK8s

MicroK8s fournit ses propres commandes start, stop et inspect au lieu de dépendre directement de systemd. Ces commandes offrent un moyen pratique de gérer le cycle de vie du cluster :

La commande microk8s inspect est destinée au dépannage — elle recueille des informations de diagnostic sur le cluster et génère une archive tar du rapport.

Conclusion

Vous avez réussi à installer MicroK8s sur Ubuntu 26.04. Votre cluster est en fonctionnement, votre utilisateur dispose des permissions de groupe nécessaires, et les add-ons principaux sont activés et prêts. MicroK8s fournit un environnement Kubernetes autonome, bien adapté au développement local, aux pipelines CI et aux déploiements en production légers sur des configurations à un ou plusieurs nœuds. Comme prochaine étape, envisagez d'explorer le clustering multi-nœuds avec microk8s add-node, ou de déployer une application exemple pour vérifier la planification de workloads de bout en bout sur votre nouveau cluster.

Questions Fréquemment Posées

1. Quelle est la différence entre MicroK8s et un cluster Kubernetes complet ? MicroK8s est une distribution Kubernetes empaquetée en un seul binaire et en snap, conçue pour la simplicité et la faible utilisation des ressources. Il exécute tous les composants Kubernetes dans un environnement snap confiné plutôt qu'en tant que services système séparés. Par conséquent, il est plus facile à installer et à gérer sur une seule machine, mais il utilise la même API Kubernetes en amont que n'importe quel cluster de production, ce qui le rend entièrement compatible avec les outils et les manifests standard.
2. Pourquoi ai-je besoin du paramètre --classic lors de l'installation de MicroK8s ? Le mode de confinement --classic permet à MicroK8s d'accéder aux ressources système qui se trouvent en dehors du bac à sable strict de Snap, telles que les interfaces réseau, les modules du noyau et le système de fichiers de l'hôte. Sans ce paramètre, MicroK8s ne peut pas fonctionner correctement car Kubernetes nécessite une intégration approfondie avec le système d'exploitation sous-jacent pour gérer les conteneurs et le réseau.
3. Comment mettre à jour MicroK8s vers une version plus récente de Kubernetes sur Ubuntu 26.04 ? Vous pouvez actualiser MicroK8s vers un nouveau canal en utilisant la commande snap refresh. Par exemple, pour passer au canal stable 1.34 : sudo snap refresh microk8s --channel=1.34/stable. MicroK8s effectuera une mise à niveau sur place, en préservant les charges de travail existantes autant que possible. Il est conseillé de sauvegarder toute configuration importante avant la mise à niveau.
4. Que faire si microk8s status indique que le cluster ne fonctionne pas ? Tout d'abord, essayez de démarrer le cluster manuellement avec microk8s start. Si le cluster ne démarre toujours pas, exécutez microk8s inspect pour recueillir les informations de diagnostic. Les causes les plus courantes incluent des ressources système insuffisantes (MicroK8s recommande au moins 2 cœurs de processeur et 4 Go de RAM), des échecs du service snap ou des modules du noyau manquants. Consultez le rapport d'inspection et vérifiez journalctl -xe pour détecter des erreurs supplémentaires au niveau du système.
5. Puis-je exécuter MicroK8s en parallèle avec Docker sur Ubuntu 26.04 ? Oui. MicroK8s utilise son propre runtime de conteneurs (containerd) qui fonctionne indépendamment du démon Docker. Les deux peuvent coexister sur le même système sans conflit. Notez que le dépôt officiel de Docker ne prend pas encore en charge Ubuntu 26.04, donc Docker doit être installé depuis le dépôt Ubuntu en utilisant sudo apt install docker.io si nécessaire en parallèle de MicroK8s.