{{tag>docker container }}


====== Docker pour le dev local ======

Atelier animé par **Augustin Riedinger** développeur freelance lors du capitole du libre 2017. Les ressources pour participer à cet atelier ont été mises à disposition par A. Riedinger aux 'URLs suivantes:

^ Les slides | https://gitpitch.com/augnustin/docker-local-slides#/  | 
^ Les tutos  | https://github.com/augnustin/docker-local-tutorial    |


===== Installation de L'environnement de travail =====


Prérequis
  * docker
  * docker-compose


==== Ubuntu 14.04 ====

  * Le dépot apt n'intègre pas **docker-compose**
  * Le paquet **docker** ne correspond pas au programme que nous cherchons à installer 

<code bash>
$ sudo apt-get install docker.io
$ sudo pip install docker-compose==1.3.0
</code> 

<note>
Veiller à bien spécifier la version de docker-compose car la dernière version utilisera un client docker trop récent par rapport à la version du serveur proposée par le dépôt apt et l'erreur suivante pourra se présenter:
 <code>
ERROR: client and server don't have same version (client : 1.21, server: 1.18)
</code>

</note>
Ajouter votre utilisateur dans le groupe **docker**

<code bash>
$ sudo usermod --append -G docker $USER
$ newgrp docker
</code>

<note>
Ajouter l'utilisateur au groupe docker permet d’éviter l'erreur suivante à l'appel de docker-compose:
<file>
ERROR: Couldn't connect to Docker daemon at http+docker://localunixsocket - is it running?

If it's at a non-standard location, specify the URL with the DOCKER_HOST environment variable.
</file>

</note>

==== Debian 9 ====


==== Les alias ====

Les alias de commandes ci-dessous n'ont rien d'obligatoire, ils permettent de simplifier les commandes de gestion des instances docker:

<code bash>
$ alias docker-enter="docker-compose run --rm --service-ports app /bin/bash"
$ alias docker-enter-again="docker-compose run --rm app /bin/bash"
$ alias docker-clean="docker ps -a | grep 'Exited\|Created' | cut -d ' ' -f 1 | xargs docker rm"
</code>

Pourquoi utiliser docker?

Pour certains projets vous aurez besoin de versions spécifiques des BD, des framework, et si vous travaillez sur plusieurs projets vous rencontrerez rapidement des problèmes de compatibilité entre les différentes versions des bibliothèques installées dans votre environnement de développement.

La solution apportée par la virtualisation virtualbox/vagrant coûte bien plus cher en ressources système.

Les containers s’exécutent sur le même système d'exploitation. Ils sont isolés des autres applications et partagent les binaires, les bibliothèques lorsque c'est approprié.

===== Tutoriel 1 =====

Tutoriel d'introduction de type "Hello World". On va exécuter un serveur web Flask avec une application minimale dans un container docker. Flask est un serveur web léger capable de servir des applications écrites en Python.

Cloner le dépôt git:

<code bash>
$ git clone https://github.com/augnustin/docker-local-tutorial

# Se placer dans le répertoire du tutoriel
$ cd docker-local-tutorial/tutorial/1-boilerplate
</code>

Le dossier contient les fichiers suivants

<file>
.
├── docker-compose.yml
├── Dockerfile
└── hello.py
</file>

La commande suivante utilise docker-compose pour démarrer le processus en environnement cloisonné:

<code bash>
$ docker-compose run --rm --service-ports app /bin/bash
</code>

Le prompt a changé, les commandes suivantes seront exécutes dans l'instance docker:

<code bash>
# Installation de pip le gestionaire de paquets python
apt-get update && apt-get install python-pip

# Installation du serveur web Flask
pip install Flask 
</code>

La portée de  ces commandes est limitée au container docker. L'installation des paquets n'a lieu que dans le container, le système n'est pas modifié.

Maintenant que le serveur Flask est installer dans le container on peut lui faire servir notre application présente dans le dossier courant:

<code bash>
FLASK_APP=hello.py flask run
</code>

Le serveur Flask s'execute à présent, pour vérifier le fonctionnement du service ouvrir un navigateur a l'URL suivante http://localhost:5000/


===== Fonctionnement =====

A propos des principaux fichier de configuration

==== Le Dockerfile ====

Ici le Dokerfile présente sa version la plus épurée. Il contient la référence du fichier image à utiliser:

<file>
FROM ubuntu:saucy
</file>

Dans l'exemple ci-dessus l'image à utiliser est dans le **dépot** officiel **ubuntu**, elle a le **tag saucy**.

===== docker-compose.yml ====

docker-compose est un utilitaire permettant de paramétrer plus simplement les instances docker à l'aide de fichier texte utilisant la syntaxe **YAML**.

Le fichier pour le tutoriel se présente ainsi:
<file>
app:
  build: .
  volumes:
    - .:/app
  ports:
    - "5000:5000"
</file>

Dans cet exemple:
  * ''app'' est le nom de l'application,
  * ''build: .'' permet de construire l'instance docker via le Dokerfile dans le répertoire courant
  * ''volumes'' liste des mappages. Le dossier courant sera monté sur le dossier /app de l'instance.
  * ''ports'' NAT des ports. Le port 5000 de l’hôte est redirigé sur le port 5000 de l'instance.


  * dockerfile FROM, RUN, COPY fichier des commandes pour mettre en état l'environnement
  * docker-compose.yml
  * docker



docker-compose fichier yaml

app: le nom du container
  volumes:
    - .:/app le dossier courant de la machine est lié a /app du container


Dans docker on a ds images 
dans docker 2 temps
  * le build


docker-compose utilise le ficheir de configuration de 

un container par service, on utilise l'image officielle de

docker-compose va nous permettre d'interconnecter les containers entre eux.


Pour créer un container soit image soit build avec en attribut le Dockerfile

alias docker-enter-again permet de reouvrir une session pour les commandes dans le container sans ecouter sur les ports

commandes permettant de lister les instances docker s’exécutant sur la machine

<code>
docker ps -a
</code>

Lister les images construites ou téléchargées

<code bash>
docker images
</code>

===== Références =====

  * https://stackoverflow.com/questions/34532696/docker-compose-cant-connect-to-docker-daemon