Léo Le Mounier -- Langlois

La ligne de commande, c'est la vie. Mais parfois, pour vérifier rapidement l'état de 50 conteneurs, lire des logs ou redémarrer un service depuis son smartphone, une interface graphique est imbattable. Portainer est le standard léger (lui-même un conteneur) pour administrer Docker.

1. Le concept de sécurité (Socket Docker)

Avant d'installer, comprenez ceci : Portainer fonctionne en se connectant au fichier /var/run/docker.sock. Ce fichier est la "télécommande" de votre démon Docker.

⚠️ Danger : Quiconque accède à Portainer a techniquement les droits Root sur votre serveur. Il faut donc impérativement protéger son accès avec un mot de passe fort et ne jamais exposer le port publiquement sans SSL.

2. Installation (Docker CE)

Comme Portainer est une application Web, nous allons l'installer... avec Docker !

Étape A : Créer un volume persistant

Portainer stocke sa base de données (utilisateurs, mots de passe, configurations) localement. Si vous ne créez pas de volume, vous perdrez votre mot de passe admin à chaque redémarrage.

docker volume create portainer_data

Étape B : Lancer le conteneur

Nous utilisons l'édition communautaire (CE) :

docker run -d -p 8000:8000 -p 9443:9443 --name portainer \
    --restart=always \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v portainer_data:/data \
    portainer/portainer-ce:latest

Explication des ports :

9443 : Interface Web HTTPS (Sécurisée). C'est celle que vous utiliserez.
8000 : Utilisé pour les agents Edge (si vous gérez plusieurs serveurs distants).

3. Premier démarrage

Accédez à https://votre-ip:9443. Votre navigateur va vous alerter que le certificat est auto-signé : c'est normal, acceptez le risque.

Créez immédiatement votre compte admin avec un mot de passe robuste (12 caractères minimum).

4. La puissance des "Stacks" (Docker Compose)

C'est la fonctionnalité "tueuse" de Portainer. Au lieu de copier des fichiers docker-compose.yml en SSH sur votre serveur, vous pouvez les coller directement dans l'interface.

Allez dans le menu Stacks à gauche.
Cliquez sur Add stack.
Donnez un nom (ex: wordpress).
Collez votre YAML dans l'éditeur Web.
Cliquez sur Deploy the stack.

Portainer va télécharger les images et lancer les conteneurs pour vous. Vous pouvez ensuite éditer le fichier en direct et cliquer sur "Update the stack" pour mettre à jour votre service.

5. Monitoring et Debugging

Portainer brille pour le diagnostic rapide :

Logs en direct : Cliquez sur l'icône "Feuille de papier" à côté d'un conteneur pour voir la sortie console (stdout/stderr). Plus besoin de grep !
Console (Exec) : Cliquez sur l'icône "Prompt" (>_) pour ouvrir un terminal Root directement dans le conteneur via votre navigateur. Idéal pour vérifier un fichier de config sans lancer PuTTY.
Stats : Visualisez la consommation CPU et RAM en temps réel pour repérer une fuite mémoire.

6. Mise à jour de Portainer

Portainer évolue vite. Pour le mettre à jour, la procédure est standard pour un conteneur : on détruit et on recrée. Grâce au volume portainer_data, vous ne perdez rien.

docker stop portainer
docker rm portainer
docker pull portainer/portainer-ce:latest
# Relancer la commande de l'étape 2...

Conclusion

Portainer ne remplace pas l'Infrastructure as Code (Ansible/Terraform) pour les gros déploiements, mais pour un Homelab ou un petit serveur VPS, c'est le couteau suisse indispensable qui vous évite bien des allers-retours en SSH.