Comment installer Docker & Portainer sur Linux

Choisir sa distribution

Le choix de la distribution est important afin d’optimiser au maximum les ressources utilisées par le système hôte.
Pour ma part, j’opte systématiquement (ou presque) pour la version Server LTS d’Ubuntu.
Elle a l’avantage d’avoir un support étendu, et d’être plus stable.
Néanmoins, ce n’est qu’une simple recommandation, et si vous vous sentez plus à l’aise sur Debian, partez sur cette dernière.

Mettre à jour sa distribution

Pour mettre à jour sa distribution Linux, rien de plus simple, puisqu’il suffit de s’y connecter en SSH.
Vous pouvez le faire nativement grâce au terminal d’une autre distribution Linux installée sur votre PC portable par exemple, et aussi depuis Windows PowerShell (Win10) ou depuis l’Invite de commandes (Win11).

sudo apt update
sudo apt upgrade -y

Voilà, votre distribution est désormais à jour, et nous pouvons maintenant passer à l’étape suivante, l’installation de Docker Engine.

Installer Docker Engine & Docker Compose

Pour se faire, on se base sur la documentation officielle de Docker.

Ajouter le repository Docker à APT

sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Le repository est désormais ajouté aux sources APT, ce qui nous permet maintenant d’installer Docker comme n’importe quelle autre application.

Installer Docker Engine & Compose

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Pour s’assurer que Docker fonctionne et connaître les versions installées, on peut taper la commande suivante.

docker -v && docker-compose --version

Enfin, on s’assure que Docker se lance au démarrage du système

sudo systemctl enable docker.service
sudo systemctl enable containerd.service

Ajouter son utilisateur au groupe Docker

Ajouter son utilisateur au groupe Docker permet de se dispenser du préfixe de commande sudo pour gérer ses containers en SSH.

En premier lieu, on crée le groupe Docker

sudo groupadd docker

Puis on ajouter son utilisateur au groupe Docker fraîchement créé

sudo usermod -aG docker $USER

Il faut ensuite se déconnecter et se reconnecter pour admirer les changements, que l’on peut vérifier avec la commande suivante

docker run hello-world

Créer le dossier Docker

Ce dossier sera la base de notre système Docker.
C’est dans celui-ci que tous les fichiers de configuration de nos applications seront mappés.

mkdir /docker
chown -R user:docker /docker

La première commande crée le dossier docker à la racine du système de fichiers.
La seconde commande donne les droits en écriture sur ce dossier à notre utilisateur et au groupe Docker.

Installer Portainer

Pour se faciliter la tâche dans le déploiement d’applications containerisées, il existe de nombreux outils.
Le plus répandu est Portainer qui, bien que certaines fonctionnalités nécessitent un abonnement business, fait totalement le travail dans sa version gratuite (Community Edition).

Pour l’installer, nous allons devoir passer par le terminal SSH.
Promis, ça sera la dernière fois que nous utiliserons le terminal pour déployer une application Docker.

On commence par créer le dossier portainer dans notre dossier docker

mkdir /docker/portainer

Ensuite il ne nous reste plus qu’à créer le container Portainer et le lancer.

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

Portainer est désormais accessible à l’adresse http://ip-ubuntu-server:9000

Rendez-vous à cette adresse et créez votre utilisateur administrateur.
Il nous faut ensuite créer l’environnement Docker local, celui que nous avons installé juste avant.
Cliquez simplement sur Get Started, et le tour est joué !

Si vous souhaitez installer une application qui utilise la commande docker run, vous pouvez la convertir en docker-compose (compatible avec Portainer) en utilisant le site Composerize.

Composerize

www.composerize.com