Portainer : gérer Docker via une interface web

Portainer : gérer Docker via une interface web

Cet article explique comment installer et utiliser Portainer pour gérer des environnements Docker via une interface graphique web, destiné aux développeurs et aux administrateurs qui souhaitent gérer plus efficacement leurs conteneurs Docker.

Prérequis

- Un serveur Linux ou Windows avec Docker installé (Docker Engine 20.10.0 ou plus récent) - Un accès au terminal avec les droits sudo - Le port 9443 libre pour le trafic HTTPS - Le port 8000 libre pour le serveur de tunnels TCP - Docker Compose (optionnel, pour des installations plus avancées)

Étapes

1. Téléchargez l'image Portainer

Tirez l'image officielle Portainer de Docker Hub. L'édition Enterprise avec support à long terme (LTS) est recommandée pour les environnements de production.

docker pull portainer/portainer-ee:lts

Pour l'édition Community, utilisez :

docker pull portainer/portainer-ce:latest

2. Créez un volume persistant

Portainer stocke les données de configuration et d'état dans un volume Docker. Cela garantit que les paramètres sont conservés après un redémarrage du conteneur.

docker volume create portainer_data

3. Démarrez le conteneur Portainer

L'installation utilise deux volumes : `/var/run/docker.sock` pour l'accès au démon Docker et `portainer_data` pour le stockage persistant. Le conteneur écoute sur le port 9443 pour HTTPS et sur le port 8000 pour le serveur de tunnels TCP.

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:/portainer_data portainer/portainer-ee:lts

4. Ouvrez l'interface web

Naviguez vers `https://localhost:9443` dans votre navigateur. Remplacez `localhost` par l'adresse IP ou le FQDN de votre serveur si vous gérez Portainer à distance.

5. Créez un compte administrateur

Lors de la première connexion, vous devez définir un nom d'utilisateur et un mot de passe pour le compte administrateur. Ce compte dispose d'un contrôle total sur l'environnement Portainer.

6. Connectez un environnement Docker

Portainer vous demande de connecter un environnement. Choisissez « Docker Standalone » si vous gérez un seul hôte Docker, ou « Docker Swarm » pour un environnement en cluster.

7. Gérez les conteneurs via l'interface

Après la connexion, vous voyez un aperçu de tous les conteneurs actifs et arrêtés, des images, des volumes et des réseaux. Vous pouvez démarrer, arrêter, redémarrer, mettre en pause ou supprimer des conteneurs via l'interface sans avoir à mémoriser les commandes CLI de Docker.

8. Utilisez les fonctions avancées

Portainer prend également en charge Kubernetes et Azure Container Instances (ACI). Via l'interface, vous pouvez ajouter et gérer ces environnements avec les mêmes outils graphiques.

Vérification

Vérifiez que Portainer fonctionne correctement avec :

docker ps | grep portainer

La sortie affiche un conteneur nommé `portainer`, avec le statut `Up` et les ports `0.0.0.0:8000->8000/tcp` et `0.0.0.0:9443->9443/tcp`.

Problèmes fréquents

1. Impossible de se connecter à https://localhost:9443

Vérifiez que le conteneur tourne avec `docker ps`. Si le conteneur n'est pas actif, consultez les journaux avec `docker logs portainer`. La cause la plus courante est un pare-feu qui bloque le port 9443.

2. Portainer perd la configuration après un redémarrage

Cela se produit lorsque le volume n'est pas correctement monté. Supprimez le conteneur et redémarrez avec la commande `docker run` complète de l'étape 3, y compris le paramètre `-v portainer_data:/portainer_data`.

3. Pas d'accès au démon Docker

Le conteneur a besoin d'accéder au démon Docker via `/var/run/docker.sock`. Vérifiez que le fichier existe sur votre hôte avec `ls -la /var/run/docker.sock`. S'il manque, vous devez réinstaller Docker ou monter le socket à un autre emplacement.

Portainer ne modifie pas la façon dont Docker fonctionne, mais ajoute une couche de gestion au-dessus des fonctionnalités existantes. L'interface traduit les actions en mêmes commandes Docker que vous exécuteriez via la CLI, comme `docker container restart` ou `docker container rm -f`. Pour les organisations qui gèrent plusieurs hôtes Docker ou une orchestration avancée, une interface centrale unique offre un moyen de réduire la complexité opérationnelle et de diminuer le risque d'erreurs. La question n'est pas de savoir si vous avez besoin d'une couche graphique, mais quand la quantité de conteneurs et d'environnements dépasse le flux de travail en CLI uniquement.