Skip to main content

Installation Portainer / portainer agent & Docker Swarm


Prérequis

  • Docker installé sur toutes vos machines.
  • Un cluster Docker Swarm initialisé (au moins un nœud manager et, facultativement, un ou plusieurs nœuds workers).

Pour installer Portainer, vous pouvez opter pour l'une des deux versions disponibles : la Community Edition (CE) ou la Business Edition (EE). Peu importe votre choix, une demande de licence est requise pour procéder à l'installation de Portainer.

Portainer CE & EE : Licences informations

Demande de licence : Portainer licence

À noter que pour la Business Edition, la possession d'une clé de licence est indispensable dès le début de l'installation. En revanche, pour la Community Edition, l'ajout d'une licence peut se faire ultérieurement et n'est pas une condition préalable à l'installation.

 

Étape 1 : Installer Portainer

Sur un nœud manager de votre Swarm, déployer un service ou une stack avec ce docker-compose.yml : 

 

version: '3'
services:
  portainer:
    image: portainer/portainer-ee:latest
    ports:
      - 8000:8000
      - 9000:9000
      - 9443:9443
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /mnt/koa-02/portainer/portainer_data:/data
    restart: always

 

Cette commande lance Portainer accessible sur le port 9000 et 9443 et lie le socket Docker pour permettre à Portainer de communiquer avec l'API Docker.

 

Étape 2 : Installer Portainer Agent

Portainer Agent permet à Portainer de gérer des nœuds distants dans un cluster Docker Swarm.

 

Déployez Portainer Agent sur le Swarm déployer un service ou une stack avec ce docker-compose.yml : 

 

version: '3.7'

services:
  agent_node_Docker:
    image: portainer/agent:2.19.4
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /var/lib/docker/volumes:/var/lib/docker/volumes
    ports:
      - "9010:9001"

 

Étape 3 : Accéder à Portainer

 

Ouvrez votre navigateur et accédez à http://<Votre-Adresse-IP-Manager>:9000 pour lancer l'interface utilisateur de Portainer.

 

image.png

Configurez votre utilisateur admin en définissant un nom d'utilisateur et un mot de passe.

 

Étape 4 : Ajouter des Environnements dans Portainer

 

Une fois connecté à Portainer :

Allez dans "Environments" (environnements) pour ajouter d'autres clusters ou nœuds Docker que vous souhaitez gérer avec Portainer.

 

image.png

 

Cliquez sur "Add environment" (ajouter un environnement) et suivez les instructions pour ajouter d'autres clusters ou instances Docker en utilisant les informations de l'agent Portainer déployé.

 

Sélectionnez Docker Swarm 

image.png

 

Puis Agent

il faut alors saisir un nom pour le SWARM et ajouter l'adresse de l'agent avec son ip et son port.

image.png

 

Site web : Portainer Agent