Environnement : Ubuntu 22.04 (amd64)

Objectif : Exécuter Minikube avec le pilote Docker

Contexte

L'installation complète de Minikube présente des défis spécifiques dans les réseaux chinois en raison des restrictions d'accès, des conflits de pilotes et des problèmes d'autorisations.

Phase 1 : Installation de Docker avec miroir alternatif

Nettoyage préalable

En cas d'erreur Conflicting values set for option Signed-By durant sudo apt update :

sudo rm -f /etc/apt/sources.list.d/docker.sources
sudo rm -f /etc/apt/sources.list.d/docker.list

Utilisation du dépôt Aliyun

# Installer les dépendances
sudo apt update && sudo apt install -y apt-transport-https ca-certificates curl gnupg

# Ajouter la clé GPG
sudo mkdir -p /etc/apt/trusted.gpg.d
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg

# Configurer le dépôt
echo "deb [arch=$(dpkg --print-architecture)] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list

# Installer Docker
sudo apt update
sudo apt install -y docker-engine docker-compose-plugin containerd

Phase 2 : Configuration des permissions

Autoriser l'utilisateur courant à exécuter Docker sans sudo :

sudo usermod -aG docker $USER
newgrp docker  # Appliquer immédiatement

Vérification : docker run hello-world doit afficher un message de succès.

Phase 3 : Déploiement de Minikube

Téléchargement

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

Démarrage du cluster

minikube delete --all  # Nettoyer les instances existantes
minikube start --driver=docker \
  --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers

Résolution des problèmes courants

• Échec d'APT : Supprimer les configurations Docker redondantes dans /etc/apt/sources.list.d/
• Blocage réseau Docker : Utiilser les miroirs Aliyun, Tuna ou USTC
• Erreurs de socket Docker : Exécuter newgrp docker ou rouvrir la session
• Téléchargement Kubernetes bloqué : Spécifier --image-repository

Commandes essentielles

• minikube status : État du cluster
• minikube ssh : Accès au nœud
• minikube dashboard : Interface web
• kubectl get pods --all-namespaces : Lister les pods

Script d'automatisation (setup.sh)

#!/bin/bash
set -e

echo "🔧 Installation de Docker via Aliyun..."
sudo apt update && sudo apt install -y apt-transport-https ca-certificates curl gnupg
sudo mkdir -p /etc/apt/trusted.gpg.d
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg
echo "deb [arch=$(dpkg --print-architecture)] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list
sudo apt update && sudo apt install -y docker-engine containerd

echo "🔑 Configuration des permissions..."
sudo usermod -aG docker $USER

echo "⚙️ Téléchargement de Minikube..."
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

echo -e "\n✅ Procédure terminée. Exécutez :\nnewgrp docker\nminikube start --driver=docker --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers"