Différences

Ci-dessous, les différences entre deux révisions de la page.

--- events:capitole-du-libre:2017:atelier-docker [2017/11/20 08:43] – yoann
+++ events:capitole-du-libre:2017:atelier-docker [2021/02/01 21:51] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 4: / Ligne 4: @@
 ====== Docker pour le dev local ======
-Conférence/atelier d' **Augustin Riedinger** développeur freelance lors du capitole du libre 2017. Les ressources pour participer à cette atelier ont été mises à disposition par A. Riedinger aux 'URLs suivantes:
+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    |
-Cloner le dépôt git:
-<code bash>
-$ git clone https://github.com/augnustin/docker-local-tutorial
-</code>
+===== Installation de L'environnement de travail =====
-===== Installation de docker =====
 Prérequis
@@ Ligne 25: / Ligne 20: @@
 ==== Ubuntu 14.04 ====
-  * le dépot apt n'intègre pas **docker-compose**
+  * 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
+$ sudo pip install docker-compose==1.3.0
 </code>
-===== Debian 9 =====
+<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>
-message erreur
+Ajouter l'utilisateur au groupe docker permet d’éviter l'erreur suivante à l'appel de docker-compose:
 <file>
- docker-compose run --rm --service-ports app /bin/bash
 ERROR: Couldn't connect to Docker daemon at http+docker://localunixsocket - is it running?
@@ Ligne 45: / Ligne 50: @@
 </file>
-utilisateur dans le groupe docker
 </note>
-Attention de ne pas se placer sur une partition avec noexec
+==== Debian 9 ====
-<code>
-sudo usermod --append -G docker user
-</code>
 ==== Les alias ====
-pourqoui? pour certains projet besoin de versions spécifiques des BD, framework, pb de compatibilité des versions.
+Les alias de commandes ci-dessous n'ont rien d'obligatoire, ils permettent de simplifier les commandes de gestion des instances docker:
-virtualbox/vagrant : lourd, coute cher en ressources
+<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?
-docker container isole les processus mais réutilise, les libs et binaires du systeme quand c'est possible.
+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.
-  * dockerfile FROM, RUN, COPY fichier des commandes pour mettre en etat l'environnement
+La solution apportée par la virtualisation virtualbox/vagrant coûte bien plus cher en ressources système.
-  * docker-compose.yml
-  * docker
-pour l'atelier
+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>
-terminal, container comme une VM
+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
@@ Ligne 109: / Ligne 197: @@
 docker images
 </code>
+===== Références =====
+  * https://stackoverflow.com/questions/34532696/docker-compose-cant-connect-to-docker-daemon

wikinotes

Outils pour utilisateurs

Outils du site

Différences

Outils de la page