# Docker/Version imprimable

* Si vous imprimez cette page, choisissez « Aperçu avant impression » dans votre navigateur, ou cliquez sur le lien Version imprimable dans la boîte à outils, vous verrez cette page sans ce message, ni éléments de navigation sur la gauche ou en haut.
* Cliquez sur Rafraîchir cette page pour obtenir la dernière version du wikilivre.
* Pour plus d'informations sur les version imprimables, y compris la manière d'obtenir une version PDF, vous pouvez lire l'article Versions imprimables.
Une version à jour et éditable de ce livre est disponible sur Wikilivres, une bibliothèque de livres pédagogiques, à l'URL : https://fr.wikibooks.org/wiki/Docker

# Introduction
## Principe

Docker est un logiciel libre conçu pour lancer des applications dans des conteneurs logiciels. Ces conteneurs sont plus légers en ressources que les machines virtuelles car ils partagent leur noyau.

## Images et conteneurs

Les conteneurs sont construis à partir d'images qui partages leur couches en différentiel.
Docker met de plus à disposition un hub pour partager des images : https://hub.docker.com/. On y trouve par exemple celles permettant de faire tourner un site en MediaWiki : https://hub.docker.com/_/mediawiki.

## Installation

Il existe plusieurs versions de Docker :
* Docker CE (community engine) : gratuit. Idéal sur un PC.
* Docker EE (enterprise engine) : version payante certifiée, plutôt pour les serveurs.
* Docker Enterprise : payant et dispose d'outils supplémentaires, par exemple pour gérer les images et les conteneurs.
Une fois installé, la commande suivante doit fonctionner : docker --version.

### Linux

En 2019 on trouve des binaires pour les distributions de Linux suivantes : CentOS, Debian, Fedora et Ubuntu.

#### Via Docker Desktop

Solution mise en avant par la doc Docker depuis 2024, mais elle peut poser des problèmes de performances et de permissions. On peut donc installer Docker avec puis le configurer pour qu'il ne se lance plus avec Docker Desktop :

#### Ubuntu - via repo

Ancienne méthode, utile pour forcer la version :

#### Post-installation

Après installation, le daemon Docker se lancera à chaque démarrage avec la possibilité de remonter certains conteneurs automatiquement.
À ce stade seul root peut utiliser Docker. Il faut ajouter les utilisateurs qui doivent le lancer au groupe "docker" :
Pour relancer Docker si besoin :
Depuis 2022, une interface graphique, Docker Desktop est disponible sur Linux :
Docker Desktop sur Linux est susceptible de retirer le daemon Docker qui marchait avant, sans pouvoir le remplacer.
L'IP du réseau de conteneurs est 172.17.0.1 par défaut (l'associer aux domaines locaux dans /etc/hosts si besoin).

### MacOS

À télécharger depuis https://docs.docker.com/docker-for-mac/install/.
A noter que les performances de Docker Desktop sur Mac ne sont pas au niveau de celles sur Linux, et qu'il existe le partagiciel Orbstack comme alternative.

### Windows

Des interfaces graphiques de gestion de conteneur existent, comme Docker Desktop ou Kitematic. Elles peuvent être intégrées dans un deuxième temps.
Mais le plus simple est de télécharger et installer Docker Desktop depuis le site officiel, car cela installe et configure aussi Docker et Docker Compose.
* Les performances de Docker Desktop sur Windows ne sont pas au niveau de celles sur Linux.
* On ne peut l'installer que pour les versions de Windows pro, car Hyper-V est nécessaire.
* Toute désinstallation de Docker supprimera les images construites sur le poste, et pourra donc occasionner de longs téléchargements après réinstallation et relance.
* En avril 2020 la version 2.3 (et les suivantes, au moins : 2.3.0.1, 2 et 3) freeze très régulièrement (broken pipe). Il était donc préconisé d'utiliser la 2.2.0.5. Mais c'est résolu dans Docker 3.0.0.

#### hosts

Sur Windows, Docker Desktop modifie le fichier hosts en ajoutant :

#### Dans un Active Directory

* Sur Windows pro en AD, il faut ajouter le compte qui utilisera Docker Desktop dans le groupe "docker-users" :
* Les versions antérieures à la 2.1.7 sur Windows pro en AD (active directory), imposent qu'un administrateur du domaine autorise l'accès à C: (un admin local ne suffit pas).

#### WSL

Anciennement baptisé Tech Preview, Docker Desktop WSL 2 Backend utilise Windows Subsystem for Linux pour optimiser les performances de Docker sur Windows, en l'installant dans une VM Linux pouvant accéder à C:.

## Références

* ↑ https://docs.docker.com/storage/storagedriver/
* ↑ https://docs.docker.com/install/overview/
* ↑ https://docs.docker.com/install/linux/docker-ce/ubuntu/
* ↑ https://github.com/docker/desktop-linux/issues/20
* ↑ https://www.ionos.fr/digitalguide/serveur/configuration/tutoriel-docker-installation-et-premiers-pas/
* ↑ https://orbstack.dev/pricing
* ↑ https://kitematic.com/
* ↑ https://docs.docker.com/docker-for-windows/install/
* ↑ https://docs.docker.com/docker-for-windows/release-notes/#docker-desktop-community-2205
* ↑ https://engineering.docker.com/2019/10/new-docker-desktop-wsl2-backend/

# Gestion des conteneurs
## Registres

Les images des conteneurs peuvent être stockées dans un registre, privé ou public comme https://hub.docker.com/.
Pour en récupérer une :
Exemple :
Les images téléchargées sont stockées :
* Sur Linux, dans /var/lib/docker/.
* Sur MacOS, dans /Users/nom_utilisateur/Library/Containers/com.docker.docker/.
* Sur Windows, dans C:\ProgramData\docker\ ou C:\ProgramData\DockerDesktop\.
Pour mettre à jour une image sur un registre à partir d'un Dockerfile :

## run

"run" s'utiliser pour lancer un conteneur à partir de son image (automatiquement téléchargée si absente en local). Une fois la commande exécutée, le conteneur s'arrête. Exemple qui liste le dossier courant :
Pour rester connecté dedans, on utilise le mode interactif (-it) :
Pour partager un dossier avec la machine hôte, on peut utiliser "-v" pour "volume", ou "--mount" si le conteneur a des services. Exemple qui liste le dossier de la machine hôte partagé avec le conteneur :

## exec

Pour exécuter une commande dans un conteneur. Ex :
Autre exemple :
Fonctionne aussi avec un fichier :

### Dans tous les conteneurs

Pour lancer une commande dans tous les conteneurs, il faut créer le fichier suivant :
Ensuite le lancer avec la commande en paramètre :

### Rentrer dans un conteneur

Pour utiliser le conteneur, on peut rentrer dedans en utilisant le mode interactif :
Cela permet d'enchainer les commandes (comme si on était sur un serveur hôte en SSH).

## build

Pour lancer un conteneur à construire, il faut le faire depuis le dossier de son Dockerfile :

## ps et rm

Pour obtenir la liste des conteneurs lancés :
Idem mais avec seulement trois colonnes, triées par nom (colonne n°2) :
Pour tous les conteneurs (lancés ou pas) :
Pour en supprimer un :

## image et rmi

Pour toutes les images :
Pour en supprimer une :

## save et load

Permet de sauvegarde une image. Pour toutes les sauvegarder :
On peut ensuite les recharger (par exemple sur une autre machine) avec :
Un save sur Docker Desktop Windows 2.3 ne permettra pas un load sur la 2.2.

## stats

Pour connaitre la consommation en ressources de chaque conteneur :
Ex :

## prune

Pour supprimer les conteneurs arrêtés :
Les images :
Les réseaux :
Les conteneurs, images et réseaux inutilisés :
Enfin pour les volumes (généralement volumineux) :
Il existe des filtres :
* -a all : supprime tout.
* -f force.
* --filter : filtre par clé valeur. Si la clé est "until", alors il filtre par date (ex : until=720h).
* --volumes : supprime les volumes des objets en paramètre.
Par exemple pour purger les images et leurs volumes toutes les nuits à 3 h, on peut créer cette tâche planifiée :

## tag

Renommer une image.

## Références

* ↑ https://docs.docker.com/storage/volumes/
* ↑ https://gist.github.com/timhodson/ea11c76424e5b3f36c017d9d0ca7ad10
* ↑ https://docs.docker.com/engine/reference/builder/
* ↑ https://docs.docker.com/engine/reference/commandline/container_prune/
* ↑ https://docs.docker.com/engine/reference/commandline/system_prune/

# Dockerfile

Une fois le processus Docker lancé, on peut commencer à lui demander de construire des conteneurs, de zéro ou à partir d'images d'un registre.

## Rôle

Il existe deux sortes de conteneur :
* Celui issu d'une image téléchargée et utilisée telle qu'elle.
* Celui construit avec des instructions personnalisées.
Par convention, les instructions pour construire un conteneur sont écrites dans un fichier appelé "Dockerfile". Il est recommandé de les placer dans un dépôt Git pour les versionner.

## Commandes Dockerfile

Les commentaires sont précédés du croisillon (#).

### ADD

Permet de copier des fichiers ou dossiers de la machine hôte vers le conteneur.
Les Dockerfile n’ont jamais accès aux volumes de l'hôte, sauf dans l’ENTRYPOINT.

### ARG

Crée une variable qui sera accessible dans la première image (FROM). Ex :
Éviter d'utiliser ce système pour bénéficier du build cache : ainsi Docker ne retéléchargera pas toutes les dépendances du Dockerfile lors du changement d'une variable située en début de Dockerfile, et n'affectant qu'une seule d'entre elles.

### CMD

Commande à exécuter au lancement du conteneur.

### COPY

Copie des fichiers ou dossiers de la machine hôte vers le conteneur. Ainsi, l'image les embarquera (contrairement à s'ils étaient montés dans un volume).
Ex :
La différence avec ADD est qu'il ne prend pas en compte les décompression de .tar et les URLs distantes.

### ENTRYPOINT

Nom d'un fichier exécutable (par exemple en shell) qui s'exécutera après chaque lancement du conteneur.
Ex :
Le fichier exécuté par l'entrypoint est le principal moyen d'accéder à la machine hôte, puisque le Dockerfile ne peut pas (en dehors de COPY qui peut la lire sans y écrire).

### ENV

Crée une variable d'environnement accessible à toutes les images du Dockerfile.

### EXPOSE

Ouvre le port logiciel mentionné du conteneur.

### FROM

Part d'une image Docker pour en créer une autre qui la complète.
Cela permet par exemple le multistage build : se servir d'une première image comme builder volumineux (avec des sources, des dépendances nécessaires à des installations), duquel on copie seulement les fichiers à utiliser dans une autre image plus légère, qui sera montée en conteneur.

### LABEL

Ajoute une description à une image.

### RUN

Lance une commande. Ex :

### STOPSIGNAL

Signal d'arrêt à envoyer au conteneur, au format nombre ou nom. Par exemple SIGKILL pour le tuer.

### USER

Se connecte à l'utilisateur et mot de passe en paramètre pour lancer les instructions RUN, CMD ou ENTRYPOINT.
Par ailleurs, pour que le conteneur possède les permissions de l'utilisateur courant :

#### Utilisation dans Docker Compose

Puis au lancement :
La présence de l'opérateur ":" dans les accolades signifie que l'on bascule vers cet utilisateur si la variable est inconnue du .env. Par exemple pour utiliser l'UID 1000 si UID= n'est pas renseigné dans le .env :

### VOLUME

Point de montage accessible par l'hôte et les autres conteneurs.

### WORKDIR

Définit le répertoire de travail, c'est-à-dire celui à partir duquel les commandes partent (ex : pwd), y compris quand on se connecte au conteneur après son montage.
Équivalent à docker --workdir.

## .dockerignore

Un fichier .dockerignore peut être placé dans un dépôt pour que son conteneur ignore le contenu qui y figure lors des commandes ADD et COPY. Exemple pour Symfony :

## Bonnes pratiques

Voir https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

## Exemples
### Apache avec PHP7.1

Voici un exemple de serveur Apache avec PHP7.1 pour MediaWiki :

### Nginx avec PHP-FPM 8.2
## Références

* ↑ https://docs.docker.com/engine/reference/builder/#add
* ↑ https://docs.docker.com/engine/reference/builder/#copy
* ↑ https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#add-or-copy
* ↑ https://docs.docker.com/engine/reference/builder/#entrypoint
* ↑ https://docs.docker.com/engine/reference/builder/#env
* ↑ https://docs.docker.com/engine/reference/builder/#expose
* ↑ https://docs.docker.com/engine/reference/builder/#from
* ↑ https://docs.docker.com/develop/develop-images/multistage-build/
* ↑ https://docs.docker.com/engine/reference/builder/#label
* ↑ https://docs.docker.com/engine/reference/builder/#user
* ↑ https://medium.com/redbubble/running-a-docker-container-as-a-non-root-user-7d2e00f8ee15
* ↑ https://docs.docker.com/engine/reference/builder/#volume
* ↑ https://snyk.io/blog/10-best-practices-to-containerize-nodejs-web-applications-with-docker/
* ↑ https://github.com/wikimedia/mediawiki-docker/blob/master/dev/Dockerfile

# Docker compose

La commande docker compose est un utilitaire généralement fourni avec Docker, permettant d'orchestrer plusieurs images et conteneurs avec la même commande. Pour ce faire, les paramétrages de l’ensemble des conteneurs doivent être définis dans le fichier docker-compose.yml à la racine du projet. Toutefois il est possible de surcharger des parties de ce fichier au lancement des conteneurs, pour chaque environnement.
Par convention, les paires clés / valeurs de ces fichiers YAML ne sont pas entre apostrophes ou guillemets, mais cela fonctionne aussi avec. Toutefois il existe deux exceptions : les versions, et les associations de ports (contenant des ":"), où les guillemets sont par contre recommandés pour éviter les conflits (avec le "." ou avec le ":" interprété avec des nombres sexagésimaux).

## Configuration YAML
### version

Version de Docker Compose. Exemple en 2023 :

### networks

Définition du réseau des VM Docker.
Ex :

### services

Liste des conteneurs à construire. Pour chacun on peut trouver :

#### image

Nom de l'image à télécharger (sur https://hub.docker.com/ ou un dépôt privé). Elle peut être suivie d'un tag pour en indiquer la version.
Exemples :

#### extends

"image" permet donc de lancer un groupe d'applications, qui sont par ailleurs lançables individuellement. Mais pour partager des configurations on peut aussi utiliser "extends" :

#### build

Alternativement à l'image, on peut indiquer le chemin d'un dockerfile pour construire son propre conteneur.
Si le conteneur ne partage aucun fichier avec d'autres, indiquer simplement le nom du dossier contenant le dockerfile :
Sinon, préciser le contexte où le conteneur devra récupérer les fichiers partagés nécessaires à son build :

#### volumes

Mapping des répertoires partagés entre la machine hôte et le conteneur :
La variable $HOME vaut "~" par défaut (dossier de l'utilisateur courant), mais peut être remplacée dans le fichier .env.

#### ports

Mapping du partage des ports. Ex :

#### environment

Injecte des variables d'environnement dans le conteneur. Très utile pour que les conteneurs soient à l'heure de la machine hôte :
environment: n'accepte pas les sous-tableaux : il faut les convertir en JSON.

#### env_file

Définit le nom d'un fichier contenant des variables d'environnement récupérables dans docker-compose.yml, avec la syntaxe "${ma_variable}". On peut aussi rajouter une valeur par défaut ensuite. Exemple :
Sur Windows le changement de l'UID entraine une modification des droits de tous les fichiers.

#### depends_on

Permet de spécifier qu'un conteneur doit en attendre un autre pour être lancé.

#### restart

Indique si le conteneur doit se lancer au démarrage du daemon Docker (donc de la machine hôte). Vaut "no" par défaut. Ex :
Autre valeur possible :

#### container_name

Permet de forcer un nom de conteneur.

#### hostname

Permet de forcer un nom de machine dans le conteneur. Utile si on a une application qui doit pointer dessus dans son .env (car "localhost" fonctionne quand le serveur était installé directement sur la machine hôte mais pas dans un conteneur).

#### network

Permet de forcer une adresse IP pour le conteneur.
Dans docker-compose.yml, il faut toujours remplir le paramètre "default" de "networks" pour ne pas qu’il prenne une plage utilisée.

#### extra_hosts

Remplit le /etc/hosts du conteneur. Ex :

#### command

Pour exécuter un script à chaque lancement du conteneur.
ou en multiligne :
</syntaxhighlight> ou :
ou si la commande est dans un fichier :

#### entrypoint

Pour définir le dernier script exécuté à chaque lancement du conteneur.

#### tty

Équivalent à docker -t : ajoute un pseudo-terminal pour interagir avec le conteneur.

## Exemples
### Minimal

Exemple de docker-compose.yml contenant un seul conteneur CentOS, qui a le droit d'accéder au dossier ~/www :

### Avec Traefik

Pour éviter de maintenir les noms de domaines des conteneurs dans le fichier hosts de la machine hôte, il existe le conteneur du proxy inverse Traefik pour mettre en l’œuvre l'association entre les conteneurs et leurs URLs.
Par ailleurs, sachant que les docker-compose.yml peuvent être utilisés dans des environnements de tests, donc sans besoin d'y accéder par des noms de domaine, il est préférable de séparer le docker-compose.yml en deux : l'un qui sera tout le temps utilisé pour l'application, et l'autre uniquement quand on veut l'utiliser manuellement en complément du premier : il faudra alors monter les conteneurs en précisant leurs deux noms.

#### docker-compose.yml

Plus besoin de fixer l'IP ici :

#### docker-compose.override.yml

Par convention, le nom du second docker-compose.yml est docker-compose.override.yml. Mais on peut en créer un par environnement (ex : docker-compose.test.yml, docker-compose.dev.yml, docker-compose.prod.yml).
Ex :
Ainsi, la base décrite dans le premier fichier sera accessible par l'Adminer du second sur http://adminer.localhost.

#### Plusieurs domaines vers le même conteneur

On peut avoir par exemple un serveur Apache avec plusieurs vhosts pointant vers des applications différentes :

## Gestion

Pour relancer le conteneur (sur Windows ou Linux) :
Pour lancer les conteneurs avec plusieurs docker-compose.yml :
Pour rentrer dedans :
Pour rentrer dedans en root :
Pour le lancer et rentrer dedans en même temps :
Pour exécuter une seule commande shell dedans sans y rentrer (en restant depuis la machine hôte) :

## Logs

Pour voir les logs de tous les conteneurs en live :
Pour voir les logs d'un seul conteneur :

### Supprimer les logs

L'emplacement des logs d'un conteneur est visible avec :

#### Sur Linux
##### Tous les conteneurs

Pour supprimer les logs de tous les conteneurs sur Linux :

##### Un seul conteneur

Pour ne supprimer les logs que d'un seul conteneur :

#### Sur Windows

Sur Windows, comme les logs sont dans le fichier C:\ProgramData\DockerDesktop\vm-data\DockerDesktop.vhdx, il faut d'abord se connecter à la VM Docker pour exécuter cette commande. Exemple en DOS :

## Références

* ↑ https://xataz.developpez.com/tutoriels/utilisation-docker/#LXII-B
* ↑ https://docs.docker.com/compose/production/
* ↑ https://docs.docker.com/compose/compose-file/#ports
* ↑ https://docs.docker.com/compose/compose-file/
* ↑ https://docs.docker.com/compose/extends/
* ↑ https://docs.docker.com/compose/extends/
* ↑ https://blog.jongallant.com/2017/11/ssh-into-docker-vm-windows/

# Kubernetes

Kubernetes est un logiciel open-source sorti en 2015 pour orchestrer de plusieurs conteneurs avec des options de quotas, scalabilité horizontale, déploiement sans coupure de service et relance automatique en cas d'indisponibilité. Pour ces raisons, il est plus orienté pour la production que pour le développement, de plus il nécessite d'utiliser des images Docker déjà construites.

## Installation
### Client

La configuration peut être stockée dans des fichiers .yaml et modifiée par la commande kubectl, ou via l'interface graphique Dashboard. De plus, il est nécessaire de lancer un cluster contenant les conteneurs via kubeadm.

#### Debian

Sur Debian ou ses dérivés :
Test :

#### k9s

Pour éviter de taper chaque commande, il existe une interface graphique gratuite nommée k9s, pouvant exploiter la conf de kubectl : https://k9scli.io/topics/install/
Par exemple on peut déclencher un cronjob avec "t" ou rentrer dans un conteneur en shell avec "s".

## Types
### pod

Un pod désigne un groupe de conteneur géré par Kubernetes.

### replica set

Un replica set désigne un ensemble de pods, dont le nombre maximum peut y être défini.

### secret

Liste de variables d'environnement chiffrées, généralement des mots de passe.
Ils sont chiffrés via "kubeseal", à partir d'un fichier YAML non versionné contenant les chaines encodées en base64.
Ce fichier contient plusieurs paramètres, par exemple le type. Il en existe huit, "opaque" étant celui par défaut.
La commande de chiffrement quant-à-elle permet de définir le scope des secrets :
* strict (par défaut) : le nom et le namespace ne peuvent pas changer sans rechiffrer.
* namespace-wide : utilisable dans tout le namespace.
* cluster-wide : utilisable dans tout le cluster.
Toutefois on peut aussi les mettre dans le .yaml. Ex : metadata:

### CronJob

Lance un conteneur dédié à une tâche planifiée (cron), à chaque fois qu'elle tourne.

### Ingress

Accès à l'application (DNS).

### PVC

Persistent volume : stocke des données indépendamment du redémarrage des pods.

## kubectl
### get

Liste des éléments du serveur :

### logs

Pour voir le log de la sortie standard d'un conteneur :

### exec

Pour rentrer dans un conteneur :

### scale

Pour augmenter le nombre de pods dans un replicatset. Par exemple si on peut passer le nombre de 2 à 3 sur "mysql" :

## Références

* ↑ https://kubernetes.io/docs/setup/
* ↑ https://kubernetes.io/fr/docs/reference/kubectl/overview/
* ↑ https://kubernetes.io/fr/docs/tasks/access-application-cluster/web-ui-dashboard/
* ↑ https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/
* ↑ https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/install-kubeadm/
* ↑ https://kubernetes.io/fr/docs/concepts/workloads/pods/pod/
* ↑ https://kubernetes.io/docs/concepts/configuration/secret/#secret-types
* ↑ https://github.com/bitnami-labs/sealed-secrets#scopes
* ↑ https://kubernetes.io/docs/concepts/workloads/controllers/cron-jobs/
* ↑ https://jamesdefabia.github.io/docs/user-guide/kubectl/kubectl_scale/

# Problèmes connus
## Accéder aux logs

Par exemple si un conteneur ne se lance pas ou se relance toutes les secondes, un motif plus précis qu'en console peut se trouver dans les logs.
Pour le démon :

### Pour les conteneurs

Ces deux commandes acceptent l'argument "-f" pour les afficher en temps réel.

### Pour un seul conteneur

ou :

## Définir les droits des fichiers partagés avec le conteneur

Si le conteneur est amené à modifier les fichiers du volume, par défaut il a les droits root de la machine hôte.
Pour éviter cela, on peut faire un chown www-data dans Dockerfile, ou utiliser UID 1000 (si le compte utilisé par la machine hôte est local).

## Réinitialiser les conteneurs à zéro

Cette opération peut prendre du temps car Docker télécharge à nouveau tous les paquets ensuite.
Linux :
Windows :
La partie network peut être exécutée indépendamment, par exemple en cas de message ERROR: Pool overlaps with other one on this address space.

## Messages d'erreur
### Sous Windows
#### /usr/bin/env: 'php\r': No such file or directory

Utiliser "winpty". Ex :
Sinon :

#### Certains conteneurs ne peuvent pas être lancés (timeout)

Vérifier que le partage Windows a bien été fait : clic droit, Settings, Resources, File Sharing, C: (puis relancer Docker Desktop).

#### Le partage de volume ne fonctionne pas sur Linux

Si ça n'a jamais fonctionné : ajouter son compte au groupe "docker" et redémarrer la machine hôte.

#### Le partage de volume ne fonctionne pas sur Windows

Si ça n'a jamais fonctionné : ajouter son compte dans le groupe "docker-users", et redémarrer la machine hôte.
C'est peut-être lié à la plage d'IP de Docker, remettre celle par défaut.
Si ça marchait sur Windows 10 pro dans un Active Directory et que ça ne fonctionne plus en dehors de l'AD ou en VPN, c'est un bug avec Docker Desktop 2.1.0.5 qui semble résolu dans la 2.1.6.1. En effet, seul un admin de l'AD peut autoriser le partage des volumes, et le port 445 doit être ouvert.
Pour tester si ça marche :

#### 500: {"Message":"Unhandled exception: Drive has not been shared"}'

Dans Docker Desktop, partager le volume concerné.

#### 502 Bad Gateway dans Nginx et Bus error dans les commandes PHP

Redémarrer Docker Desktop.
Sinon c'est un processus PHP qui gonfle à outrance à cause du code.

#### ERROR: failed to create new listening socket: socket: Address family not supported by protocol (97)

Relancer Docker Desktop.

#### Error: mounting wslCLIDest: stat /mnt/host/c/Program Files/Docker/Docker/resources/wsl/docker-wsl-cli.iso: no such file or directory

Décocher Use the WSL 2 based engine dans les options et relancer Docker Desktop.

#### fatal: not a git repository (or any parent up to mount point /var) Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set)

Redémarrer Docker Desktop.

#### Error response from daemon: Mount denied: The source path "mon_dossier;C" doesn't exist and is not known to Docker

Sous Git Bash dans Windows, il faut préfixer le chemin local par "/". Ex : docker run -it --rm -v /${PWD}:/wkDir $IMAGE_TAG yarn dev

#### Invalid mode /var/www

Le chemin d'accès dans docker-compose.yml n'est pas compris. Cela se produit pas exemple quand on met des antislashs à la place des slashs.

### Sous Linux
#### standard_init_linux.go:211: exec user process caused "no such file or directory"

Cela peut se produire quand des conteneurs testés sur Linux sont utilisés sur Windows.
Il faut changer les retours chariots du fichier appelé par "ENTRYPOINT" dans le Dockerfile, de CRLF (Windows) vers LF (Unix). Ex : dos2unix php7.4-fpm/bin/custom-docker-php-entrypoint
Puis reconstruire et relancer le conteneur.

##### Autres solutions

On peut aussi lancer "dos2unix" automatiquement depuis le dockerfile sur une copie de l'exéutable.
S'il s'agit d'un dépôt Git, on peut aussi le sauvegarder autrement depuis Linux :
* lancer git config core.autocrlf false
* créer un fichier .gitattributes contenant text eol=lf

#### container_linux.go:349: starting container process caused "exec: \"custom-docker-php-entrypoint\": executable file not found in $PATH": unknown

Cela peut se produire quand des conteneurs testés sur Windows sont utilisés sur Linux.
Il faut changer leur donner les droits d'exécution (chmod +x).
Puis reconstruire et relancer le conteneur.

### Pour tout OS
#### /bin/sh: no such file or directory

Forcer la reconstruction :

#### Cannot connect to the Docker daemon. Is the docker daemon running on this host?

Si ça ne marche pas, relancer docker en administrateur.

#### Cannot start service xxx: Address already in use

Deux processus utilisent le même port.
* Si c'est deux conteneurs, dans Docker Compose, si l'un des deux avait été retiré, il était peut-être configuré en restart: always et il faut le remettre dans docker-compose.yml pour le stopper.
* Si l'un vient de la machine hôte, l'identifier avec sudo netstat -tulpn | grep ':80 ' puis le stopper.

#### Cannot start service xxx :driver failed programming external connectivity on endpoint

Impossible de lancer un conteneur sur Windows :
* Soit Docker n'a pas accès au volume, et il faut cocher la case "Shared drives" dans Docker Desktop, ou lancer la commande suivante en acceptant le partage :
* Soit Docker n'a pas accès aux ports de ses conteneurs, et il faut fermer les processus qui les utilisent. Il peut même s'agir d'une deuxième instance de Docker.

#### Couldn't connect to Docker daemon at http+docker://localhost - is it running?

Si le démon ne se lance pas, upgrader l'OS et redémarrer. Sinon, réinstaller Docker.

#### Could not resolve host: xxx (pas de DNS)

Revoir la plage d'IP définie dans le paragraphe "networks" de docker-compose.yml.

#### Device or resource busy, Cette action ne peut pas être réalisée car le fichier est ouvert dans com.docker.backend.exe

C'est un bug connu (sur Linux et Windows) quand composer installe certains paquets. On ne peut supprimer le fichier qu'en fermant tout Docker (sous Windows en tout cas, il ne suffit pas de le redémarrer).
Cela se produit (en cas de réécriture d'historique ?), repartir d'une branche propre avant de relancer "composer install". Sinon, le lancer dans une VM et récupérer le dossier vendor.

#### Error response from daemon: Get https://xxx: no basic auth credentials

Sur certains dépôts privés, pour faire un docker pull il faut préalablement se loguer. Ex :

#### Invalid interpolation format for "environment" option in service "documents": "^https?://.*?$"

Échapper le $ interprété dans docker-compose.yml. Par exemple, remplacer :
par :

### "encore dev-server --host my_url" ne marche pas

Mapper l'URL définie dans cette commande de package.json, avec 0.0.0.0 dans docker-compose.yml :

## Références

* ↑ https://www.thetopsites.net/article/50789087.shtml
* ↑ https://github.com/docker/for-win/issues/6822
* ↑ https://stackoverflow.com/questions/50608301/docker-mounted-volume-adds-c-to-end-of-windows-path-when-translating-from-linux
* ↑ https://willi.am/blog/2016/08/11/docker-for-windows-dealing-with-windows-line-endings/
* ↑ https://stackoverflow.com/questions/53165471/building-docker-images-on-windows-entrypoint-script-no-such-file-or-directory
* ↑ https://git-scm.com/docs/gitattributes
* ↑ https://github.com/moby/moby/issues/22260