Dans ce tutoriel nous allons voir comment fonctionne docker et nous allons présenter quelques fonctionnalités incontournables de docker.  Si vous lisez cet article, nous supposons que vous avez déjà lu notre article précédent sur la découverte de docker ou alors vous avez lu d’autres articles sur internet, donc vous savez au moins ce qu’est docker. Mais ne vous inquiétez pas, la présentation est très explicite donc pas besoin d’être un pro sur docker pour lire cet article il faut juste savoir de quoi il est question. Bon assez bavardé…. Action.

1. Dockerfile et Cycle de vie d’un conteneur

1.1. Cycle de vie des images et des conteneurs

Avant toute chose il est important de savoir que sur docker nous manipulons des Dockerfile qui sont compilés en images et ensuite instanciés en Conteneur. Donc en gros l’on part d’un fichier Dockerfile qui nous permet de construire une image qui une fois instanciée va devenir un conteneur. Le conteneur ainsi instancié reste toutefois lié à son image de départ.

Voici un schéma illustrant le cycle de vie d’un conteneur avec les commandes du client Docker :

Quelque commandes qui vous seront surement très utiles :

[pastacode lang= »apacheconf » manual= »docker%20images%20%3A%20Lister%20les%20images%20pr%C3%A9sentes%20en%20local%0Adocker%20ps%C2%A0%3A%20Liste%20les%20conteneurs%20d%C3%A9marr%C3%A9s%0Adocker%20ps%20%E2%80%93a%C2%A0%3A%20Liste%20tous%20les%20conteurs%20(ceux%20qui%20sont%20d%C3%A9marr%C3%A9s%2C%20arr%C3%AAt%C3%A9s%20normalement%20ou%20apr%C3%A8s%20une%20erreur)%0Adocker%20log%C2%A0%3A%20attache%20la%20sortis%20console%20%C3%A0%20celle%20du%20conteneur.%0Adocker%20stop%20%24(docker%20ps%20-q)%C2%A0%3A%20arr%C3%AAter%20tous%20les%20conteneurs%20lanc%C3%A9s%20d%E2%80%99un%20coup%20de%20baguette%20magique.%0Adocker%20start%20%24(docker%20ps%20-q)%20%3A%20relancer%20en%20m%C3%AAme%20temps%20tous%20les%20conteneurs%20qui%20ont%20%C3%A9t%C3%A9%20arr%C3%AAt%C3%A9s%20et%20qui%20sont%20en%20m%C3%A9moire.%0Adocker%20exec%20-it%20Nom_Du_Conteneur%20%2Fbin%2Fbash%20%3A%20Se%20connecter%20au%20Shell%20d%E2%80%99un%20conteneur.%0Adocker%20rm%C2%A0%20%24(docker%20ps%20-a%C2%A0%20-q%20–filter%20%22status%3Dexited%22)%20%3A%20Effacer%20tous%20les%20conteneurs%20arr%C3%AAt%C3%A9s%20d%E2%80%99un%20coup%20de%20baguette%20magique. » message= » » highlight= » » provider= »manual »/]

1.2 Dockerfile

Le fichier qui nous permet de créer des images s’appelle un  Dockerfile. C’est un fichier qui permet de décrire comment une image sera construite avec la commande docker build. Il contient le nom de l’ensemble des paquets qui seront installés dans l’image, les répertoires qui seront partagés par l’image, les ports qui seront exposés, l’ensemble des variables d’environnements qui seront instanciés de base, etc.

Syntaxe

Voici la syntaxe de base d’un Dockerfile qui vous permettra de décrire une image et la manière dont elle sera créée:

[pastacode lang= »apacheconf » manual= »MAINTAINER%20%3Cname%3E%0AFROM%20%3Cimage%3E%0AENV%20%3Ckey%3E%20%3Cvalue%3E%0AADD%20%3Csrc%3E%20%3Cdest%3E%0AVOLUME%20%5B%22%2F%3Cdir%3E%22%5D%0AUSER%20%3Cuser%3E%0AEXPOSE%20%3Cport%3E%0ARUN%20%3Ccommand%3E%C2%A0%C2%A0%20ou%C2%A0%20RUN%20%5B%22ex%C3%A9cutable%22%2C%20%22param1%22%2C%20%22param2%22%5D%0ACMD%20%3Ccommand%3E%C2%A0%C2%A0%20ou%C2%A0%20CMD%20%5B%22ex%C3%A9cutable%22%2C%20%22param1%22%2C%20%22param2%22%5D » message= » » highlight= » » provider= »manual »/]

 Légende :

MAINTAINER  <name> : Auteur de l’image vous pouvez mettre votre nom par exemple

FROM <image> : Nom de l’image de base. Cela permet de ne pas partir de rien et d’utiliser une image existante. Par exemple se base sur une image Debian pour créer un conteneur APACHE.

ENV <key> <value> : Permets de définir des variables d’environnement qui seront créées lors de l’instanciation du conteneur. Ex : MYSQL_PASSWORD qui permettra à celui qui lance l’instance du conteneur de passer le mot de passe de SQL via l’option -e.

ADD <src> <dest> : Il permet de récupérer des fichiers en local et de les uploader dans l’image lors de sa compilation. Ces fichiers feront désormais partie de l’image.

VOLUME [« /<dir> »] : Répertoire monté au démarrage du conteneur et qui est externe à celui-ci. Cela permet de rendre des fichiers du conteneur directement accessible sur l’hôte.

USER <user> : Permets d’indiquer l’utilisateur Linux qui sera utilisé lors du démarrage du conteneur.

EXPOSE <port> : Permet d’indiquer les ports réseaux exposés par le conteneur. Il définir sur quels ports réseau les conteneurs communiquent avec l’extérieur.

RUN <command>   ou  RUN [« exécutable », « param1 », « param2 »] : Il permet d’exécuter une commande sur l’image lors de sa création. Ex : run apt-get install apache

CMD <command>   ou   CMD [« exécutable », « param1 », « param2 »] :

• il faut noter qu’il ne doit y avoir qu’un seul CMD dans un Dockerfile. c’est une commande qui est lancée dans les conteneurs qui utilisent cette image à chacun de leurs démarrages.
• Si l’image contient le serveur NGINX, il peut s’agir de lancer l’exécution du serveur NGINX au démarrage du conteneur.
• La commande n’est lancée qu’à l’exécution du conteneur et non durant la construction de l’image
• Cette commande peut être redéfinie dans la commande de lancement du conteneur (Docker run)

2. Réseau et partage de fichier sous docker

Sachez-le.  Quoi que vous fassiez sur docker, quel que soit l’architecture que vous déciderez de mettre en place vous utiliserez forcement de manière consciente ou non le réseau et/ou le  partage de fichier.

1.1 Partage de fichier

Le partage de fichier se fait dans un conteneur en réalisant le montage de volumes disques ce qui permettra à un conteneur d’utiliser le contenu d’un répertoire de la machine hôte. Le conteneur peut ainsi avoir des fichiers que nous aurons définis (fichier de conf par exemple) lors de son premier démarrage et ces fichiers sont stockés sur la machine hôte donc ils ne seront pas effacés lors de l’arrêt et de la suppression du conteneur.

• Le partage de fichiers nécessite de :
  • Créer le répertoire de partage sur la machine hôte (machine utilisée pour le lancement du conteneur)
  • Spécifier le répertoire de partage au sein du conteneur (dans le Dockerfile)
• Ajouter la ligne suivante dans le fichier Dockerfile pour indiquer quel répertoire du conteneur sera partagé :

VOLUME [« [répertoire du conteneur] »]

• Au lancement du conteneur, indiquer le mapping entre le répertoire de partage du conteneur et la machine hôte.
• Dans la commande docker run, ajouter l’option -v [répertoire de la machine hôte]:[répertoire du conteneur] pour mapper le répertoire de la machine hôte avec celui du conteneur:

 docker run -v [host directory]:[container directory]

ajouter :ro à la fin pour activer la lecture seule :

docker run -v [host directory]:[container directory]:ro

1.2 Communications réseau.

L’interfaçage réseau permet à un conteneur de communiquer avec l’extérieur et/ou avec les autres conteneurs. Pour définir l’interfaçage réseau, il est nécessaire de :

• Exposer le port réseau du conteneur :
  • soit dans le fichier Dockerfile de l’image : EXPOSE [port conteneur]
  • soit via l’option –expose de la commande docker run : –expose [port conteneur]

Pour que le port réseau du conteneur soit accessible à l’extérieur de la machine hôte nous devons mapper le port réseau du conteneur avec celui de la machine hôte via l’option -p de la commande docker run. Le mappage peut être manuel ou automatique :

• Pour Mapper manuellement les ports. Dans ce cas nous fixons manuellement qu’elles port de l’hôte et du conteneur seront mappez ensemble.[pastacode lang= »apacheconf » manual= »Utilisation%20%3A%20%0Adocker%20run%20-p%20ip%C2%A0%3Aport%2Fprotocole%C2%A0%20%C2%A0%0Adocker%20run%20-p%20%5Bport%20h%C3%B4te%5D%3A%5Bport%20conteneur%5D%0Adocker%20run%20-p%20%5BIP%5D%3A%5Bport%20h%C3%B4te%5D%3A%5Bport%20conteneur%5D%0Adocker%20run%20-p%20%5BIP%5D%3A%5Bport%20h%C3%B4te%5D%3A%5Bport%20conteneur%5D%2F%5Bprotocol%5D%0A%0ANB%C2%A0%3A%C2%A0%C2%A0%20%0A%5BIP%5D%20%3A%20Adresse%20IP%20(non%20obligatoire)%2C%0A%5Bport%20h%C3%B4te%5D%20%3A%20Port%20de%20la%20machine%20h%C3%B4te%2C%20%C2%A0%0A%5Bport%20conteneur%5D%20%3A%20Port%20du%20conteneur%2C%20%C2%A0%0A%5Bprotocol%5D%20%3A%20Protocol%20r%C3%A9seau%20(non%20obligatoire)%20(exemple%20%3A%20tcp%20ou%20udp). » message= » » highlight= » » provider= »manual »/]

  Il est possible de définir plusieurs mapping de ports à l’aide de plusieurs options -p dans la même commande docker run: docker run …  -p 80:80  -p 8080:8080

• Mapper automatiquement tous les ports exposés d’un conteneur avec des ports livre de la machine hôte.

L’option -P de docker run utilisée toute seule sans spécification de numéro de port permet de mapper chacun des ports exposés d’un conteneur sur un des ports de la machine hôte sur une plage comprise entre 49000 et 49900.

[pastacode lang= »bash » manual= »docker%20run%20…%20-p » message= » » highlight= » » provider= »manual »/]

Il faudrait alors lancer la commande docker ps pour voir sur quels ports de la machine hôte sont mappés les ports du conteneur.

Pour qu’un conteneur puisse communiquer directement avec un autre conteneur sans forcément avoir besoin de leur affecter des ports sur la machine hôte, il est nécessaire de lié les 2 conteneurs. Pour cela on lance un 1^er conteneur et ensuite au lancement du 2^ème  conteneur on le lie au 1^er.  Cela permet ainsi au 2^ème conteneur d’avoir des informations sur le 1^er Conteneur. On devra donc lancer le 2^ème conteneur avec en plus le paramètre.

[pastacode lang= »bash » manual= »%20Docker%20run%20%E2%80%A6%20%20–link%3D%5Bnom%20conteneur%20li%C3%A9%5D%3A%5Balias%20du%20conteneur%5D%20″ message= » » highlight= » » provider= »manual »/]

[nom conteneur lié] : Nom du conteneur lié qui doit être en cours d’exécution (le nom de conteneur doit avoir été défini lors du lancement de ce conteneur via l’option –name de la commande docker run)

[alias lien] : alias du lien dans le conteneur

Docker vas fournir au deuxième conteneur les variables d’environnement qui ont été déclarées pour le 1^er  conteneur dans le fichier Dockerfile ou via la commande docker run (via l’aide des options -e). Ces variables d’environnements sont préfixés par le nom de l’alias qui a été formaté en majuscules. Ex: Pour un alias apache, les variables d’environnement commencent par APACHE_.

Le conteneur lié doit être en cours d’exécution et doit donc être dans la liste des conteneurs en cours d’exécution via la commande docker ps. Le nom d’alias sert au nommage des variables d’environnement dans le conteneur qui va appeler le 1^er. Donc en gros pour le 2^ème conteneur c’est-à-dire celui qui appel. Le conteneur 1 nommé [nom conteneur lié] sur la machine hôte aura pour nom [alias lien]  dans le conteneur.

Voilà en gros à quoi cela peut ressembler schématiquement.

Le conteneur 1 expose le port 111. Nous démarrons le premier conteneur :

[pastacode lang= »bash » manual= »docker%20run%20-d%20–name%20conteneur1%20–expose%20111%20demo%2Fimage1″ message= » » highlight= » » provider= »manual »/]

Nous démarrons un second conteneur en le liant avec le premier conteneur :

[pastacode lang= »bash » manual= »docker%20run%20-d%20–name%20conteneur2%20-P%20–link%20conteneur1%3Ain_conteneur1%20demo%2Fimage2″ message= » » highlight= » » provider= »manual »/]

Docker ajoute dans le conteneur 2 des variables d’environnement concernant le conteneur 1 pour chaque port exposé par le conteneur 1 :

Pour le port 111 du conteneur 1 :

[pastacode lang= »apacheconf » manual= »IN_CONTENEUR1_PORT_111_TCP_ADDR%3D172.17.0.2%0AIN_CONTENEUR1_PORT_111_TCP_PORT%3D111%0AIN_CONTENEUR1_PORT_111_TCP_PROTO%3Dtcp » message= » » highlight= » » provider= »manual »/]

Nous pouvons ainsi récupérer l’adresse IP du conteneur lié pour que le conteneur 2 puisse communiquer avec le conteneur 1.

Si le conteneur 1 exposait le port 22 avec un serveur SSH, le conteneur 2 pourra se connecter en SSH sur ce premier conteneur via le port 22 et en utilisant la variable d’environnement contenant l’adresse IP « IN_CONTENEUR1_PORT_22_TCP_ADDR« .

Exemple : MySql + Drupal

Démarrer conteneur SQL

[pastacode lang= »bash » manual= »docker%20run%20-d%20-v%20%2Fhome%2Fjoel%2Fdata%2Fwebstack%2Fbdd%2F%3A%2Fvar%2Flib%2Fmysql%20-e%20MYSQL_ROOT_PASSWORD%3Ddocker2016%20–name%20webstack_mysql%20mysql » message= » » highlight= » » provider= »manual »/]

Démarrer Conteneur Drupal lié à SQL

[pastacode lang= »bash » manual= »docker%20run%20–name%20drupal_01%20–link%20webstack_mysql%3Amysql%20-p%203001%3A80%20%C2%A0-d%20drupal » message= » » highlight= » » provider= »manual »/]

Démarrage de WordPress lié à SQL

[pastacode lang= »bash » manual= »docker%20run%20–name%20wordpress_01%20–link%20webstack_mysql%3Amysql%20-v%20%2Fdata%2Fwebstack%2Fwordpress%2F1%2F%3A%2Fvar%2Fwww%2Fhtml%2F%20-p%203002%3A80%20-d%20wordpress » message= » » highlight= » » provider= »manual »/]

Attention: il n’est possible de communiquer qu’avec les ports exposés d’un conteneur. Même entre 2 conteneur lié.

1.3 Changer les paramètres spécifiés lors de l’exécution du conteneur

Il n’y a pas de commande docker pour modifier les informations spécifiées via la commande docker run  du conteneur lors de l’exécution de celui-ci, que ce soit le mapping des ports réseau ou des fichiers.

Il faut alors enregistrer l’état ‘Commiter’ et redémarrer le conteneur en spécifiant le nouveau mapping de ports ou de fichiers. Lors du commit, il faut indiquer le nouveau nom d’image d’export  qui sera utilisé pour redémarrer le conteneur à partir de cette image (en gros c’est le nom de l’image de sauvegarde). Il ne faut pas utiliser le nom de l’image initial qui avait servi lors du premier démarrage du conteneur.

docker commit [identifiant] [nom image temporaire]

docker run (…) [nom image temporaire] (…)

3.    Webographie

Blog2dev  « Réseau et Fichiers »