virli/tutorial/docker-basis/linking.md

\newpage

Lier les conteneurs
===================

Lorsque l'on gère des services un peu plus complexes qu'un simple gestionnaire
d'images, on a souvent besoin de faire communiquer plusieurs services
entre-eux.

Notre premier service, `youp0m`, utilisais le système de fichiers pour stocker
ses données, mais la plupart des applications réclament un serveur de base de
données.

Les bonnes pratiques nous dictent de ne pas placer plus d'un service par
conteneur : en effet, on peut vouloir mettre à jour l'applicatif sans pour
autant redémarrer sa base de données, etc. Nous allons donc voir dans cette
partie comment lier deux conteneurs.


## Mise en place du webservice

Nous allons utiliser l'interface d'administration des serveurs du FIC :
[`nemunaire/fic-admin`](https://hub.docker.com/r/nemunaire/fic-admin/).

En lançant le conteneur avec les mêmes options que `youp0m`, les journaux
indiquent que le service cherche à se connecter à une base de données. Il va
donc falloir lier notre interface d'administration à un conteneur MariaDB.


## Les pilotes réseau

Docker propose de base trois pilotes (*drivers*) pour « gérer » cela :

- `none` : pour limiter les interfaces réseau du conteneur à l'interface de
  loopback `lo` ;
- `host` : pour partager la pile réseau avec l'hôte ;
- `bridge` : pour créer une nouvelle pile réseau par conteneur et rejoindre un
  pont réseau dédié.


Ces trois *drivers* sont instanciés de base dans Docker avec le même nom que
leur pilote. Pour consulter la liste de réseaux utilisables, lancez :

<div lang="en-US">
```
42sh$ docker network ls
NETWORK ID          NAME                DRIVER              SCOPE
74cedd3ff385        bridge              bridge              local
d5d907add6e2        host                host                local
16b702ed01a0        none                null                local
```
</div>

Par défaut, c'est le réseau `bridge` (de type `bridge`) qui est employé : ce
réseau utilise le pont `docker0` que vous pouvez voir dans vos interfaces
réseau via `ip link`. C'est via ce pont que les conteneurs peuvent avoir accès
à Internet, au travers d'une couche de NAT.

Pour changer le réseau principal joint par le conteneur, utiliser l'option
`--network` du `docker container run`.


### Le réseau `host`

En utilisant ce réseau, vous abandonnez tout isolation sur cette partie du
conteneur et partagez donc avec l'hôte toute sa pile IP. Cela signifie, entre
autre, que les ports que vous chercherez à allouer dans le conteneur devront
être disponibles dans la pile de l'hôte et également que tout port allouer sera
directement accessible, sans avoir à utiliser l'option `-p` du `run`.


### Créer un nouveau réseau `bridge`

Afin de contrôler quels échanges peuvent être réalisés entre les conteneurs, il
est recommandé de créer des réseaux utilisateur.

La création d'un réseau se fait tout simplement au travers des sous-commandes
relatives aux objets Docker `network` :

<div lang="en-US">
```bash
docker network create --driver bridge my_fic
```
</div>

C'est ensuite ce nom de réseau que vous passerez à l'option `--network` de vos
`run`, ou vous pouvez également faire rejoindre un conteneur déjà lancé à un
réseau :

<div lang="en-US">
```bash
docker network connect NETWORK CONTAINER
```
</div>

Lorsque plusieurs conteneurs ont rejoint un réseau utilisateur, ils peuvent
mutuellement se découvrir grâce à un système de résolution de nom basé sur leur
nom de conteneur.


## Exercice  {-}

À vous maintenant de connecter une instance de `nemunaire/fic-admin` à sa base
de données.

Ne vous embêtez pas avec les mots de passes des services, initialisez la base
de données avec le nom d'utilisateur et le mot de passe par défaut. Vous les
obtiendrez en lisant l'aide :

<div lang="en-US">
```bash
docker container run --rm -e MYSQL_HOST="tcp(mysql_cntr_name:3306)" nemunaire/fic-admin -help
```
</div>

Notez la définition de la variable d'environnement `MYSQL_HOST`[^12factors],
celle-ci indique le nom du serveur vers lequel le service doit se connecter.

[^12factors]: Lecture intéressante : <https://12factor.net/>

Vous aurez besoin de créer un volume pour stocker la base de données, un réseau
dans lequel vous connecterez la base de données et le conteneur applicatif.

Vous devriez pouvoir déboguer le réseau, au sein d'un conteneur, par exemple en
utilisant :

<div lang="en-US">
```
42sh$ docker container exec -it ficadmin_cntr_name /bin/bash
(incntnr)# ping mysql_cntr_name
```
</div>

Une fois le service `fic-admin` lancé, vous pouvez exposer le port 8081, sur
lequel vous devriez voir l'interface d'admin : <http://localhost:8081/>.