Comment installer Portainer sur Ubuntu 22.04 ?

Introduction

Cette page explique comment exécuter Docker sur Ubuntu 22.04. Portainer est une interface de gestion légère et open-source pour Docker. Elle permet aux utilisateurs de gérer et de surveiller les environnements Docker, y compris les conteneurs, les images, les réseaux et les volumes, par le biais d'une interface web. Avec Portainer, vous pouvez facilement déployer, exécuter et gérer des conteneurs, ainsi que configurer et surveiller l'état de leurs environnements Docker.

Ce qui suit suppose que Docker est déjà installé. Si ce n'est pas le cas, veuillez lire cette page sur comment installer Docker sur Ubuntu 22.04.

Nous supposons également que Docker peut être utilisé en tant qu'utilisateur non root.

Les étapes présentées sur cette page ont été testés avec ces versions :

Ubuntu 22.04.1 LTS (Jammy Jellyfish)
Docker 20.10.22
Portainer Community Edition 2.16.2

Mise à jour du système

Commencez par mettre à jour votre système avec la commande suivante :

sudo apt update -y && sudo apt upgrade -y

Volume persistant

Portainer a besoin de données persistantes (pour stocker le mot de passe de l'utilisateur par exemple). Créons un volume docker pour stocker ces données :

docker volume create portainer_data

Une fois le volume créé, vous pouvez inspecter le volume pour obtenir son emplacement par exemple :

docker volume inspect portainer_data

Lancer Portainer

Une fois le volume créé, exécutez la commande suivante pour démarrer portainer dans un conteneur :

docker run -d -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce

Voici le détail de chaque option :

docker run est la commande de base pour démarrer un conteneur
-d signifie detach. Il exécute le conteneur en arrière-plan.
-p exposer l'interface utilisateur sur le port 9000, l'interface web de portainer sera à l'URL hostname:9000.
--name=portainer nomme le conteneur portainer
--restart=always redémarre toujours Portainer (après un crash ou au redémarrage de la machine ou du deamon)
-v /var/run/docker.sock:/var/run/docker.sock monte le volume /var/run/docker.sock de la machine hôte vers le conteneur Portainer. /var/run/docker.sock est en fait le socket du démon Docker. Portainer a besoin de cette socket pour obtenir le statut de Docker.
-v portainer_data:/data monte le volume créé précédemment
portainer/portainer-ce est le nom de l'image [Portainer Community Edition] (https://hub.docker.com/r/portainer/portainer-ce).

Docker devrait télécharger et exécuter l'image de Portainer :

$ docker run -d -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
Unable to find image 'portainer/portainer-ce:latest' locally
latest: Pulling from portainer/portainer-ce
772227786281: Pull complete 
96fd13befc87: Pull complete 
0bad1d247b5b: Pull complete 
b5d1b01b1d39: Pull complete 
Digest: sha256:f7607310051ee21f58f99d7b7f7878a6a49d4850422d88a31f8c61c248bbc3a4
Status: Downloaded newer image for portainer/portainer-ce:latest
e2d55a08eae21f03deb3e68f375b79f01a6956c00e68453b37dc2509682ff758

Une fois l'image lancée, ouvrez votre navigateur web préféré et allez à l'URL du portainer localhost:9000 :

La première fois que Portainer démarre, il vous demande de définir un mot de passe. Le mot de passe doit comporter au moins 12 caractères. Une fois le mot de passe saisi, la page suivante devrait apparaître dans le navigateur :

Sélectionnez Get Started (sauf si vous devez vous connecter à un autre environnement). Vous devriez voir au moins un environnement nommé local.

Sélectionnez l'environnement local, vous devriez voir au moins

un conteneur en cours d'exécution (portainer)
une image (portainer)
un volume (portainer_data)

Naviguez à travers l'interface utilisateur pour découvrir toutes les possibilités de Portainer. Redémarrez la machine et vérifiez que Portainer est lancé au démarrage.

Voir aussi

Dernière mise à jour : 28/12/2022