C’est parti pour le premier article très technique de l’année 2017. On va franchir ensemble un nouveau palier dans Docker.  Mais ne vous inquiétez pas, tout va très bien se passer. Si Docker ne vous dit strictement rien, ou si vous avez besoin de vous rafraîchir la mémoire, pas de problème. Je vous conseille de lire mon article Qu’est-ce que Docker, et comment ça fonctionne ?

Installation de Docker

Avant de commencer et pour éviter que vous soyez frustrés, je vous invite à installer Docker afin de tester les commandes que je vous propose de découvrir aujourd’hui.

Voici les liens de téléchargement :

Docker pour Windows 10	Docker pour les Windows en dessous de Windows 10	Docker pour macOS Yosemite ou supérieur	Documentation Docker Ubuntu

C’est une installation classique, je ne me fais pas de souci pour vous. Pour ceux qui sont sur Linux, vous avez l’habitude des documentations donc je ne m’en fais pas non plus.

Après l’avoir installé, lancez une console Docker. Pour ceux qui sont sur Linux ou Mac, c’est directement dans le terminal. Quant à ceux qui sont sur Windows, il faut lancer PowerShell ou la console Docker.

Pour utiliser Docker, vous devez être en root, ou en Admin pour Windows.

Maintenant, vous êtes prêts. Si vous avez des soucis, les commentaires sont là pour ça…

Je vous propose de commencer tout en douceur avec les commandes Docker, et j’augmenterai le niveau au fur et à mesure.

Les meilleures commandes de Docker

On commence par appréhender Docker en tapant tout simplement “docker” dans votre console.

docker

Le rendu est le suivant :

Usage: docker [OPTIONS] COMMAND [arg...]
docker [ --help | -v | --version ]

A self-sufficient runtime for containers.

Options:

--config=~/.docker Location of client config files
-D, --debug Enable debug mode
-H, --host=[] Daemon socket(s) to connect to
-h, --help Print usage
-l, --log-level=info Set the logging level
--tls Use TLS; implied by --tlsverify
--tlscacert=~/.docker/ca.pem Trust certs signed only by this CA
--tlscert=~/.docker/cert.pem Path to TLS certificate file
--tlskey=~/.docker/key.pem Path to TLS key file
--tlsverify Use TLS and verify the remote
-v, --version Print version information and quit

Commands:
attach Attach to a running container
build Build an image from a Dockerfile
commit Create a new image from a container's changes
cp Copy files/folders between a container and the local filesystem
create Create a new container
diff Inspect changes on a container's filesystem
events Get real time events from the server
exec Run a command in a running container
export Export a container's filesystem as a tar archive
history Show the history of an image
images List images
import Import the contents from a tarball to create a filesystem image
info Display system-wide information
inspect Return low-level information on a container, image or task
kill Kill one or more running containers
load Load an image from a tar archive or STDIN
login Log in to a Docker registry.
logout Log out from a Docker registry.
logs Fetch the logs of a container
network Manage Docker networks
node Manage Docker Swarm nodes
pause Pause all processes within one or more containers
port List port mappings or a specific mapping for the container
ps List containers
pull Pull an image or a repository from a registry
push Push an image or a repository to a registry
rename Rename a container
restart Restart a container
rm Remove one or more containers
rmi Remove one or more images
run Run a command in a new container
save Save one or more images to a tar archive (streamed to STDOUT by default)
search Search the Docker Hub for images
service Manage Docker services
start Start one or more stopped containers
stats Display a live stream of container(s) resource usage statistics
stop Stop one or more running containers
swarm Manage Docker Swarm
tag Tag an image into a repository
top Display the running processes of a container
unpause Unpause all processes within one or more containers
update Update configuration of one or more containers
version Show the Docker version information
volume Manage Docker volumes
wait Block until a container stops, then print its exit code

Je vous ai surligné les commandes que nous allons utiliser dans cet article, et dans les suivants. Celles-ci vous permettront de bien comprendre la base de Docker.

On va commencer par un petit TP, qui consiste à démarrer un conteneur qui se nomme Hello-world. Pour ceux qui ne connaissent pas Hello-world, il s’agit de la première étape quand un développeur commence à apprendre un nouveau langage.

Bref, commençons par utiliser la commande suivante :

docker images

Cette fonction nous permet d’afficher la liste des images installées dans notre Docker. Si c’est la première fois que vous utilisez Docker, vous devriez obtenir ce résultat :

Maintenant, nous allons remplir notre liste d’images en téléchargeant un premier système. Pour cela, je vous conseille d’aller faire un tour dans le hub Docker pour vous rendre compte des possibilités. Voici le lien : Docker Hub.

C’est un peu comme un Play Store ou l’Apple Store. Vous y trouverez une liste d’images disponibles, leur note et le nombre de “pulls”. Vous devez certainement reconnaître certains logos, comme Ubuntu, MongoDB, MySql ou encore ElasticSearch. Tout ces systèmes, qui peuvent paraître longs à installer et à paramétrer, sont désormais simples à appeler. Prenons un exemple simple : le hello-world, fait pour ceux qui débutent. Si vous cliquez dessus, vous allez voir le détails et la description de ce que contient le repository (un stockage centralisé – sur le Docker Hub dans notre cas). Et à droite, on vous indique la commande pour télécharger l’image.

docker pull hello-world

Voici le résultat :

Docker vous dit qu’il va télécharger la version qui se nomme latest (la dernière postée par les développeurs). Ensuite, il vous spécifie qu’il a téléchargé l’image.

Si on lance un :

docker images

On voit apparaître notre jolie image :

On obtient plein d’informations en effectuant cette commande : on connaît le nom du repository, et le tag pour savoir sur quelle branche du projet nous sommes.

Pour ceux qui ne savent pas ce qu’est une branche, voici une petite explication. Quand on développe un projet correctement on utilise Git comme moyen “d’archivage de code“. Et très souvent on crée plusieurs branches pour un même projet. Cela permet de diviser le projet en plusieurs versions. Par exemple vous avez créé une version “dev”, qui est la dernière version en cours de développement, mais qui contient probablement des bugs. On peut avoir la branche “release stable” qui est la version publiée et accessible au public, c’est à dire la version stable. On peut aussi avoir une branche anglaise, etc. Je pense que vous avez compris le concept.

Ensuite, on a l’image ID qui est très utile pour lancer un conteneur, la date de création pour se rappeler si ça fait longtemps qu’on l’a téléchargée, et la taille qui peut être importante si vous exportez votre image – pour différentes raisons – sur clé USB par exemple. Si la taille est énorme, cela risque d’être compliqué.

Maintenant, voici la question qui doit vous brûler les lèvres : comment lancer un conteneur ?

Comment lancer un conteneur ?

Et bien c’est très simple. Bien évidemment il s’agit du premier TP, on corsera les choses au fur et à mesure.

docker run hello-world

Avant de vous montrer le résultat, je vais vous expliquer ce que fait la commande.

Elle veut dire : “lance moi l’image qui se nomme hello-world“. Et si vous avez bien suivi, il y a une autre manière de faire. On peut l’appeler par son ID (moi je préfère, c’est plus sûr si on a plusieurs versions d’images).

docker run c54a2cc56cbb

Et voici le résultat de la commande :

Donc cela signifie que l’on a bien lancé l’image hello-world. Pour vérifier que le boulot a bien été fait, on va voir du côté des conteneurs. On lance la commande suivante :

docker ps -l

Cette commande va afficher la liste des conteneurs créés récemment sur votre machine. Pour avoir la liste complète, il faut faire un ps -a.

On voit que le conteneur 71a… a été créé 9 minutes plus tôt et qu’il est arrêté (voir le statut). Dernière information importante, il se nomme fervent_turing. Oui, Docker aime bien générer des noms sympas. Mais moi ça ne me plaît pas, alors je décide de changer son nom grâce à la commande suivante :

docker rename 71a mon_test

 

Puis j’effectue un ps – l pour voir le résultat.

On observe que le nom s’est transformé en mon_test (voir en bas à droite).

Maintenant qu’on a fini de se servir de hello-world et que vous avez tout compris, je vous propose de le supprimer.

Pour supprimer l’image, il suffit d’écrire la ligne suivante :

docker rmi hello-world

Et le résultat est sans équivoque :

Si vous comprenez l’anglais, vous avez dû voir que Docker n’accepte pas la suppression d’une image tant qu’un des conteneurs l’utilise encore.

Nous allons donc supprimer mon conteneur “mon_test”.

docker rm mon_test

Voici le résultat, rien de special.

On vérifie avec un

docker ps -a

 

On voit bien que je n’ai plus aucun conteneur…

On va pouvoir s’attaquer a l’image, en réitérant la même commande que précédemment.

docker rmi hello-world

 

Docker nous indique qu’il a bien supprimé l’image. Je vous laisserai faire un docker image pour vous en assurez.

C’est donc fini pour ce premier TP. Si vous avez des soucis, vous pouvez me contacter par mail, sur les réseaux sociaux, ou encore mieux les commentaires. Et n’hésitez pas à partager l’article à votre entourage ;-).

Dans le prochain article prévu prochainement, nous créerons un site WordPress fonctionnel, entièrement grâce à Docker, et avec peu de lignes de commande. Elle est pas belle la vie ? A bientôt pour de nouvelle aventures !

Photo : “Overlooking the Harbour”, Chris Lawton.