Qu'est-ce que Portainer ?

Portainer est une interface web intuitive et légère pour gérer vos environnements Docker. C'est un outil open-source qui simplifie la gestion de vos conteneurs, images, volumes et réseaux Docker.

Fonctionnalités principales :

  • Interface graphique : Gestion visuelle de vos conteneurs Docker
  • Gestion des images : Téléchargement, construction et suppression d'images
  • Gestion des volumes : Création et gestion des volumes persistants
  • Gestion des réseaux : Configuration des réseaux Docker
  • Monitoring : Surveillance des ressources et des performances
  • Multi-environnements : Gestion de plusieurs serveurs Docker
  • Sécurité : Authentification et gestion des utilisateurs

Installation de Portainer

Commande unique d'installation

docker run -d \
  --name portainer \
  -p 9000:9000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  portainer/portainer

Explication des paramètres

  • -d : Lance le conteneur en arrière-plan (mode détaché)
  • --name portainer : Nomme le conteneur "portainer"
  • -p 9000:9000 : Expose le port 9000 du conteneur sur le port 9000 de l'hôte
  • -v /var/run/docker.sock:/var/run/docker.sock : Monte le socket Docker pour permettre à Portainer de communiquer avec le daemon Docker
  • portainer/portainer : Image Docker officielle de Portainer

Configuration initiale

Accès à l'interface web

  1. Ouvrez votre navigateur
  2. Accédez à http://votre-serveur:9000
  3. Vous verrez l'écran de configuration initiale

Première configuration

  1. Créer un compte administrateur :

    • Choisissez un nom d'utilisateur
    • Définissez un mot de passe sécurisé
    • Confirmez le mot de passe

  2. Sélectionner l'environnement :

    • Choisissez "Local Docker Environment"
    • Cliquez sur "Connect"

Utilisation de Portainer

Tableau de bord principal

Une fois connecté, vous accédez au tableau de bord qui affiche :

  • Conteneurs : Liste de tous vos conteneurs avec leur statut
  • Images : Images Docker disponibles
  • Volumes : Volumes persistants
  • Réseaux : Réseaux Docker configurés

Gestion des conteneurs

  • Voir les logs : Cliquez sur un conteneur pour voir ses logs
  • Démarrer/Arrêter : Boutons pour contrôler l'état des conteneurs
  • Supprimer : Supprimer des conteneurs inutiles
  • Créer : Créer de nouveaux conteneurs via l'interface

Gestion des images

  • Télécharger : Puller de nouvelles images depuis Docker Hub
  • Construire : Construire des images depuis un Dockerfile
  • Supprimer : Nettoyer les images inutilisées

Commandes utiles

Vérifier le statut de Portainer

docker ps | grep portainer

Voir les logs de Portainer

docker logs portainer

Arrêter Portainer

docker stop portainer

Redémarrer Portainer

docker restart portainer

Supprimer Portainer

docker stop portainer
docker rm portainer

Sécurité

Bonnes pratiques

  1. Changer le port par défaut :

    docker run -d --name portainer -p 8080:9000 -v /var/run/docker.sock:/var/run/docker.sock portainer/portainer

  2. Utiliser un reverse proxy avec HTTPS

  3. Restreindre l'accès au socket Docker si possible

  4. Changer régulièrement le mot de passe administrateur

Accès sécurisé

Pour un accès plus sécurisé, vous pouvez :

  • Utiliser un reverse proxy (Nginx, Traefik)
  • Configurer l'authentification LDAP
  • Limiter l'accès par IP
  • Utiliser des certificats SSL

Dépannage

Portainer ne démarre pas

docker logs portainer

Problème de permissions

sudo chmod 666 /var/run/docker.sock

Accès refusé

Vérifiez que le port 9000 n'est pas déjà utilisé :

netstat -tulpn | grep 9000

Conclusion

Portainer est un outil essentiel pour quiconque utilise Docker régulièrement. Il simplifie grandement la gestion de vos conteneurs et offre une interface intuitive pour tous les aspects de Docker.