Guide Complet : Installer la Stack Portainer-Agent dans Portainer

by  on  in Accueil

Portainer est un gestionnaire de conteneurs Docker qui facilite la gestion et la supervision des environnements conteneurisés. L’ajout d’un agent Portainer (Portainer-Agent) permet de superviser des environnements distants. Dans ce guide, nous allons détailler chaque étape pour installer la stack Portainer-Agent sur un environnement simple. Ce tutoriel est conçu pour les débutants et couvre les deux côtés : le serveur Portainer et l’agent.

Prérequis

  1. Un serveur avec Portainer déjà installé.
  2. Un second serveur (ou machine virtuelle) pour déployer l’agent.
  3. Docker installé sur les deux machines.

Partie 1 : Configurer le Serveur Portainer

Étape 1 : Accéder à l’interface Portainer

  1. Ouvrez un navigateur web.
  2. Connectez-vous à votre instance Portainer en saisissant l’URL (par exemple : http://<adresse-ip-portainer>:9000).
  3. Authentifiez-vous avec vos identifiants.

Étape 2 : Créer un environnement Docker

  1. Cliquez sur « Environments » dans le menu principal.
  2. Cliquez sur « Add environment ».
  3. Choisissez l’option « Agent ».
  4. Saisissez un nom pour cet environnement (par exemple : Agent-Remote).
  5. Notez le port par défaut (9001). Ce port sera utilisé par l’agent pour communiquer avec le serveur Portainer.
  6. Cliquez sur « Add environment » pour valider.

Partie 2 : Installer l’Agent Portainer-Agent

Étape 1 : Préparer le serveur distant

  1. Connectez-vous à la machine distante (via SSH ou en local).
  2. Assurez-vous que Docker est installé et fonctionnel.
  3. Vérifiez que le port 9001 est ouvert (par exemple, via ufw ou les règles de pare-feu).

Étape 2 : Déployer l’agent

  1. Exécutez la commande suivante pour déployer le conteneur Portainer-Agent :
docker run -d \
  -p 9001:9001 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  --name portainer-agent \
  portainer/agent

Étape 3 : Vérifier le déploiement

  1. Exécutez docker ps pour vérifier que le conteneur est bien en cours d’exécution.
  2. Assurez-vous que le port 9001 est accessible depuis le serveur Portainer (vous pouvez utiliser telnet ou un test curl).

Partie 3 : Connecter le Serveur et l’Agent

Étape 1 : Retourner sur l’interface Portainer

  1. Naviguez de nouveau vers la section « Environments ».
  2. Cliquez sur l’environnement que vous venez de créer.

Étape 2 : Tester la connexion

  1. Cliquez sur « Check connection » pour vérifier que le serveur peut communiquer avec l’agent.
  2. Si tout est configuré correctement, vous devriez voir un statut indiquant que la connexion est active.

Conclusion

Félicitations ! Vous avez maintenant configuré un environnement distant avec l’agent Portainer. Vous pouvez désormais superviser et gérer vos conteneurs Docker depuis une interface centralisée.

N’hésitez pas à explorer les différentes fonctionnalités offertes par Portainer pour optimiser la gestion de vos environnements Docker.