virli/tutorial/docker-basis/installation.md

\newpage

Installation

Avant de voir de quoi il s'agit, afin de gagner du temps, nous allons commencer par installer Docker.

Prérequis

Docker repose sur plusieurs techniques implémentées dans les récents noyaux Linux (et plus marginalement, Windows). Nous consacrerons les prochains cours à comprendre leur fonctionnement. Ces techniques, contrairement aux instructions de virtualisation qui rendent les hyperviseurs attractifs, ne sont pas limitées à une architecture de microprocesseur spécifique ; cependant la communauté autour de Docker utilise principalement l'architecture amd64, c'est sur cette dernière que Docker pourra être exploité à son plein potentiel, suivi de près par l'architecture arm64.

Avant de continuer, assurez-vous que votre machine a bien démarré sur un noyau 64 bits. Le retour de la commande uname -m doit vous indiquer :

``` x86_64 ```

Ou si vous êtes intrépide :

``` aarch64 ```

Assurez-vous également d'avoir un noyau récent, avec la commande uname -r :

``` 5.14.4-gentoo ```

Rassurez-vous, même si vous n'avez pas compilé le dernier noyau disponible sur kernel.org, Docker s'utilise à partir de Linux 3.10.

Par le gestionnaire de paquets

En général, votre distribution mettra à votre disposition une version de Docker plus ou moins récente. Sous Debian et ses dérivés (Ubuntu, Mint, ...) le paquet a été nommé docker.io.

Si dans un environnement de production, on préférera sans doute utiliser une version déjà bien éprouvée (comme celle des dépôts de sa distribution), pour ce cours, nous allons avoir besoin de la dernière version disponible. Référez-vous à la documentation officielle correspondant à votre distribution :

https://docs.docker.com/engine/install/debian/

Et Kali Linux alors ? Kali étant basée sur Debian, référez-vous à la procédure d'installation de cette distribution.

Windows et macOS

Bien que les fonctionnalités de contenerisation de Docker que nous utiliserons ne soient disponibles que sous Linux, il est possible d'utiliser Docker de manière déportée : le daemon Docker tournera dans une VM Linux, mais vous pourrez interagir avec lui via votre ligne de commande habituelle.

Téléchargez la version correspondante à votre système d'exploitation :

• Docker Desktop for Mac
• Docker Desktop for Windows

Une fois l'installation terminée, lancez l'application : elle ajoutera une icône dans la zone de notification, vous permettant de contrôler l'exécution de la machine virtuelle sous-jacente.

Notez que depuis septembre 2021, ces applications passent sous une licence payante pour les grosses entreprises¹. Cela ne nous concerne pas, car la licence est gratuite pour un usage éducatif ou personnel. Notez que ce n'est pas le binaire Docker qui change de licence, elle reste libre, mais seulement les applications Docker Desktop.

Évaluation en ligne

Si vous rencontrez des difficultés pour vous lancer, le projet Play With Docker vous donne accès à un bac à sable dans lequel vous pourrez commencer à faire ce TP.

Il vous faudra disposer d'un compte Docker. Une fois identifié, vous pourrez créer une nouvelle instance, et vous connecter dessus via SSH.

Vérifier la bonne marche de l'installation

Vous devriez maintenant être capable de lancer la commande suivante :

```bash docker version ```

Une sortie similaire au bloc suivant devrait apparaître sur votre écran :

``` Client: Version: 20.10.8 API version: 1.41 Go version: go1.16.6 Git commit: 3967b7d28e Built: Wed Aug 4 12:55:42 2021 OS/Arch: linux/amd64 Context: default Experimental: false

Server: Engine: Version: 20.10.8 API version: 1.41 (minimum version 1.12) Go version: go1.16.6 Git commit: 75249d88bc Built: Wed Aug 4 12:55:42 2021 OS/Arch: linux/amd64 Experimental: true containerd: Version: 1.5.5 GitCommit: 72cec4be58a9eb6b2910f5d10f1c01ca47d231c0.m runc: Version: 1.0.2 GitCommit: v1.0.2-0-g52b36a2d docker-init: Version: 0.19.0 GitCommit: de40ad0

</div>


### Problèmes courants

#### `no such file or directory`?

Si vous avez cette erreur : `dial unix /var/run/docker.sock: no such file or
directory.`, le deamon n'est sans doute pas lancé. Lancez-le :

<div lang="en-US">
```bash
sudo service docker restart

permission denied?

Si vous avez cette erreur : dial unix /var/run/docker.sock: permission denied., ajoutez votre utilisateur au groupe docker et relancez votre session :

```bash sudo gpasswd -a $USER docker ```

Attention : cette action n'est pas anodine d'un point de vue sécurité : https://docs.docker.com/engine/security/#docker-daemon-attack-surface

---

1. https://www.docker.com/blog/updating-product-subscriptions/ ↩︎