Comment installer et utiliser Portainer pour gérer les conteneurs Docker

Ce guide étape par étape montre comment installer Portainer pour prendre le contrôle de vos conteneurs Docker via une interface graphique pratique.

Dans le monde de la conteneurisation, Docker est devenu une force dominante, révolutionnant la façon dont les applications logicielles sont déployées et gérées.

Cependant, à mesure que les environnements Docker gagnent en complexité et en évolutivité, la gestion des conteneurs et l’orchestration de leurs opérations peuvent devenir de plus en plus difficiles.

C'est là qu'intervient Portainer en tant qu'outil d'interface utilisateur graphique (GUI) puissant et convivial explicitement conçu pour simplifier la gestion des conteneurs Docker.

Qu’est-ce que Portainer ?

Portainer est un outil conçu pour simplifier la gestion et la surveillance des conteneurs Docker. Il fournit une interface graphique conviviale, permettant aux utilisateurs d'interagir facilement avec Docker et d'effectuer des tâches liées aux conteneurs sans opérations de ligne de commande complexes.

Portainer permet aux utilisateurs de gérer les conteneurs Docker, les images, les réseaux et les volumes via une interface Web intuitive. Il offre une plate-forme centralisée pour la gestion des conteneurs, ce qui en fait un choix idéal pour les utilisateurs expérimentés de Docker et ceux qui découvrent la conteneurisation.

De plus, Portainer prend en charge la gestion de plusieurs hôtes Docker, ce qui en fait un excellent choix pour les organisations ou les individus travaillant avec des déploiements Docker complexes dans différents environnements.

Dans le même temps, Portainer peut fonctionner avec Docker Compose, permettant aux utilisateurs de déployer et de gérer facilement l'intégralité de la pile d'applications définie dans Docker Compose, d'afficher l'état et les journaux des conteneurs individuels et de faire évoluer les services selon leurs besoins.

Enfin, l’application ne se limite pas uniquement à Docker. Portainer prend également en charge Kubernetes et Docker Swarm, permettant aux administrateurs de gérer et de sécuriser rapidement le cluster.

Qu'est-ce que l'agent Portainer ?

Portainer propose un agent distant – un composant léger et autonome qui fonctionne avec Portainer pour fournir des fonctionnalités avancées de gestion de conteneurs.

Il fonctionne comme un conteneur sur l'hôte distant et agit comme un pont entre Portainer et l'environnement Docker, permettant la gestion des ressources Docker distantes.

De plus, Portainer Agent permet à une seule instance Portainer de se connecter à plusieurs hôtes Docker, éliminant ainsi le besoin d'un accès direct à l'hôte distant Dockerisé ou à des configurations réseau complexes.

En d’autres termes, en offrant une gestion centralisée de plusieurs instances Docker distantes, Portainer Agent rend la gestion Docker distante transparente et efficace.

Éditions Portainer

Portainer propose deux éditions différentes, chacune répondant à différents besoins et environnements d'utilisateurs.

Édition communautaire Portainer (CE)

Portainer CE est une offre gratuite et open source destinée aux utilisateurs individuels, aux petites équipes et à une utilisation non commerciale. Il fournit une interface Web conviviale pour gérer les conteneurs, les images, les réseaux et les volumes Docker, adaptée à la plupart des besoins de gestion Docker. Il offre un ensemble complet d'outils et de fonctionnalités sans aucun frais de licence.

Portainer Business Edition (BE)

Portainer BE est l'édition commerciale de Portainer, conçue pour les organisations et les utilisateurs d'entreprise. Il s'appuie sur les fonctionnalités de Portainer CE mais inclut des fonctionnalités, une assistance et des services avancés supplémentaires conçus pour répondre aux besoins des équipes plus grandes, des déploiements complexes et des environnements de production.

Par exemple, Portainer BE offre des fonctionnalités supplémentaires telles que le contrôle d'accès basé sur les rôles (RBAC), l'intégration LDAP/AD, des fonctionnalités de sécurité améliorées, des contrôles d'accès précis, la gestion du cycle de vie des conteneurs, etc.

Le tableau ci-dessous montre les différences entre les deux éditions.

Conditions préalables

Avoir Docker installé est indispensable pour installer Portainer. Donc, si Docker n’est pas déjà installé, vous devez l’installer avant d’installer Portainer.

Voici quelques guides pour vous aider à le faire rapidement en quelques minutes seulement.

• Comment installer Docker sur Ubuntu 24.04
• Comment installer Docker sur Debian 12 (Bookworm)
• Comment installer Docker sur Arch Linux
• Comment installer Docker sur Linux Mint 22
• Comment installer Docker sur AlmaLinux/Rocky Linux
• Comment installer Docker sur Fedora
• Comment installer Docker sur Raspberry Pi

L'autre composant essentiel est Docker Compose. N'oubliez pas qu'il est fourni séparément de Docker. Par conséquent, vous devez installer Docker avant d’ajouter Docker Compose ; sinon, Compose ne fonctionnera pas.

Son installation est assez simple, même s'il n'est pas déjà présent sur votre système Linux. Pour installer Docker Compose, tapez les deux commandes suivantes :

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-linux-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Docker Compose n'est pas requis pour utiliser Portainer. Néanmoins, il est fortement recommandé car il vous permet de profiter de tout le potentiel de Docker en déployant vos applications/piles multi-conteneurs Dockerisées via l'interface Web conviviale de Pontainer.

Enfin, si votre système Linux utilise SELinux, il doit être désactivé avant d'installer Portainer. Cependant, si vous avez besoin de SELinux, vous devez transmettre l'indicateur --privileged à Docker lors du déploiement de Portainer.

Comment installer Portainer

Avant de commencer, il est important de noter que Portainer peut être installé sur diverses plates-formes, notamment Linux, Windows et macOS. Ce guide se concentrera sur l'installation de Portainer CE (Community Edition) sur Linux.

Étape 1 : Créer un volume Docker

Tout d’abord, nous allons créer un volume Docker appelé « portainer_data » pour conserver les fichiers de configuration de Portainer.

docker volume create portainer_data

Si l’opération réussit, le résultat de la commande affichera le nom du volume.

Étape 2 : Installer Portainer CE sous Linux

Après avoir créé le volume, utilisez la commande suivante pour déployer le conteneur Portainer lui-même.

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

Maintenant, décomposons la syntaxe et expliquons la signification de chaque valeur.

• -d : demande à Docker d'exécuter le conteneur en mode détaché (en arrière-plan).
• –name : spécifie le nom du conteneur.
• -p : expose les ports 8000 et 9443 du Portainer par défaut aux ports 8000 et 9443 de l'hôte.
• –restart : demande à Docker de redémarrer le conteneur s'il se ferme pour une raison quelconque.
• -v : étant donné que Portainer doit communiquer avec le démon Docker pour gérer les conteneurs, vous devez monter le socket Docker de l'hôte dans le conteneur. De plus, nous montons le volume Docker que nous avons créé précédemment dans le conteneur, où les fichiers de configuration de Portainer seront stockés.
• La dernière option spécifie l'image Docker à partir de laquelle notre conteneur sera créé. Nous utilisons la version la plus récente de l'édition Portainer CE, disponible sur Docker Hub.

La commande extraira l'image Portainer Docker et démarrera le conteneur. Nous pouvons vérifier si Portainer est en cours d’exécution en tapant la commande ci-dessous, qui répertorie les conteneurs Docker actuellement en cours d’exécution sur notre système.

docker ps

Comme vous pouvez le voir sur le résultat ci-dessus, notre serveur Portainer est en cours d'exécution.

Accéder à l'interface utilisateur Web de Portainer

Pour accéder au tableau de bord Portainer, chargez « https://localhost:9443 » dans votre navigateur. Étant donné que Portainer émet un certificat SSL auto-signé, un message de risque de sécurité potentiel s'affiche. Acceptez-le pour continuer.

Vous serez redirigé vers une page où vous pourrez créer le compte administratif pour votre instance Portainer. Saisissez un nom d'utilisateur (la suggestion par défaut est « admin ») et un mot de passe d'au moins 12 caractères, puis cliquez sur le bouton « Créer un utilisateur ».

La page « Configuration rapide » apparaîtra. À partir de là, vous pouvez ajouter des environnements Docker à votre serveur Portainer.

Cependant, comme nous avons monté le socket Docker de l'hôte sur le conteneur Portainer lorsque nous avons démarré le conteneur, il est déjà connecté. Alors, cliquez sur le bouton « Accueil ».

Portainer vous montrera qu'il est connecté à votre environnement Docker local, nommé « local ». Cliquez dessus.

Félicitations! À partir de là, en utilisant le menu de gauche, vous pouvez désormais créer et gérer vos conteneurs, réseaux, images et volumes Docker à l'aide de l'interface utilisateur Web pratique de Portainer.

Connecter Portainer à l'environnement Docker distant

Tout d'abord, vous devez installer l'agent Portainer pour connecter un Portainer à un environnement Docker distant et gérer les conteneurs.

Alors, connectez-vous au serveur distant (qui doit exécuter Docker) via SSH par exemple, et exécutez la commande ci-dessous pour installer l'agent Portainer.

docker run -d \
  -p 9001:9001 \
  --name portainer_agent \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  portainer/agent:2.18.3

Ensuite, revenez à Portainer et dans le menu de gauche, choisissez « Environnements », puis cliquez sur le bouton « Ajouter un environnement ».

Choisissez « Docker Standalone » et cliquez sur « Démarrer l'assistant ».

Dans le champ « Nom », spécifiez un nom pour l'environnement Docker distant. Ensuite, saisissez l'adresse IP du serveur suivie de « :9001 » dans le champ « Adresse d'environnement ». Enfin, cliquez sur le bouton « Connecter ».

Vous devriez recevoir un message indiquant que la connexion a réussi. Pour revenir au tableau de bord du Portainer, cliquez sur le logo dans le coin supérieur gauche.

L'environnement Docker distant nouvellement ajouté est désormais sur la liste des environnements disponibles. Cliquez dessus.

Vous pouvez désormais gérer votre environnement Docker distant via Portainer, tout comme votre environnement local.

Conclusion

L'installation et l'utilisation de Portainer pour gérer les conteneurs Docker fournissent une solution puissante et conviviale pour gérer efficacement les applications conteneurisées, ce qui en fait un outil idéal pour les individus et les organisations de toutes tailles.

Avec son interface intuitive et son ensemble complet de fonctionnalités, Portainer simplifie la gestion et la surveillance des conteneurs Docker, le rendant accessible même à ceux ayant une expertise technique limitée.

Pour obtenir une aide supplémentaire ou des informations utiles, nous vous recommandons de consulter la documentation officielle de Portainer ou de visiter le site Web du projet.