Installer Docker sur un Raspberry Pi

Docker est un logiciel qui vous permet d’installer et d’exécuter des logiciels dans des conteneurs séparés, en virtualisant le système d’exploitation en cours d’exécution. Les principaux avantages de Docker sont la facilité de déploiement, la sécurité et l’évolutivité.

Pour démarrer avec Docker sur Raspberry Pi OS, assurez-vous de remplir quelques conditions préalables.

Exigences du système d’exploitation

Pour installer Docker, vous avez besoin de l’une des versions de système d’exploitation suivantes :

Système d’exploitation Raspberry Pi Bookworm 12 (stable)
Système d’exploitation Raspberry Pi Bullseye 11 (oldstable)

Bien sûr il faut installer le système d’exploitation avant tout. Pour ça vous pouvez suivre ce tutoriel.

Désinstaller les anciennes versions

Avant de pouvoir installer Docker, vous devez désinstaller tous les packages qui risquent d’être en conflit.

Les packages non officiels à désinstaller sont :

docker.io
docker-compose
docker-doc
podman-docker

De plus, Docker dépend de containerd et runc. Docker regroupe ces dépendances dans: containerd.io. Dans le cas ou containerd.io est déjà installé, il faut le désinstaller pour éviter les conflits avec les versions fournies avec Docker.

Pour cela exécutez la commande suivante pour désinstaller tous les packages en conflit :

 for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt remove $pkg; done

apt peut signaler qu’aucun de ces packages n’est installé.

Méthodes d’installation

Installer à l’aide du référentiel apt

Avant d’installer Docker pour la première fois sur une nouvelle machine hôte, on a besoin de configurer le dépôt Docker. Ensuite, vous pouvez installer et mettre à jour Docker depuis le référentiel.

sudo apt update
sudo apt install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/raspbian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/raspbian \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update

Pour installer la dernière version, exécutez :

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

Vérifiez que l’installation a réussi en exécutant l’habituel hello-world:

sudo docker run hello-world

Cette commande télécharge une image de test et l’exécute dans un conteneur. Quand le Le conteneur s’exécute, il imprime un message de confirmation et se ferme.

Vous avez maintenant installé et démarré avec succès Docker.

Conseil:

Si vous recevez une erreur lorsque vous essayez d’exécuter Docker sans sudo, vous devez ajouter votre utilisateur au groupe docker.

Le groupe d’utilisateurs docker existe mais ne contient aucun utilisateur, c’est pourquoi vous devez utiliser sudo pour exécuter les commandes Docker. Pour permettre aux utilisateurs non privilégiés d’exécuter des commandes Docker et pour d’autres étapes de configuration facultatives, il faut ajouter votre utilisateur dans le groupe docker.

sudo usermod -aG docker $USER

Ensuite il suffit de se déconnecter et de se reconnecter avec le même utilisateur.

Pour vérifier que vous pouvez exécuter la commande docker sans sudo.

docker run hello-world

Installation de Compose

Maintenant que Docker est bien installé et fonctionne, on va installer le plugin Compose.

Compose est un outil permettant de définir et d’exécuter des applications Docker multi-conteneurs. Avec Compose, vous utilisez un fichier YAML pour configurer les services de votre application. Ensuite, avec une seule commande, vous créez et démarrez tous les services à partir de votre configuration.

sudo apt install docker-compose-plugin

Pour finir vérifiez que Docker Compose est correctement installé en vérifiant la version.

docker compose version