docker hub – Introduction

27 janvier 2021

–> NOTE: Cette version n’est plus mise à jour – voir: https://github.com/ve2cuy/4204d4

Publier une IMAGE à partir d’un conteneur PERSONNALISÉ et Stockage PERSISTANT

Dans ce module nous verrons comment;

Personnaliser un conteneur (nginx)
Produire une image à partir d’un conteneur personnalisé
Créer un dépôt docker hub
Publier une image personnalisée dans un dépôt docker hub.
Mettre en place un stockage persistant

PRÉ-REQUIS: Un compte d’accès à hub.docker.com

Mise en situation

Lors du dernier module, nous avons apprivoisé quelques commandes de base sur des conteneurs d’images préexistantes.

Pourquoi ne pas créer notre propre image à partir du conteneur d’une de ces images?

Mais avant, un petit retour en arrière

# Afficher l'aide de docker
docker

# Afficher l'aide d'un sous-système docker
docker container -- help
docker container ls

# Recherche d'une image sur hub.docker.com
docker search arch

# Obtenir une image de hub.docker.com
docker pull archlinux

# Démarrer un conteneur en arrière plan
docker run -d archlinux 
# Le conteneur archlinux n'a pas de tâche en boucle il va donc s'arrêter.

# Démarrer un conteneur en mode interactif
docker run -it archlinux

#Installer nano dans le conteneur archlinux
pacman -Sy nano
nano hello.txt
exit

# La commande 'exit' provoque l'arrêt du conteneur
# Il est possible de sortir sans provoquer l'arrêt avec CTRL P+Q
docker ps
docker ps -a

# Démarrer un conteneur arrêté - sans créer une nouvelle instance
docker start ID-archlinux
# Note restart = stop/start
docker attach ID-archlinux
exit
NOTE: le conteneur s'est arrêté.

# Exécuter, en mode interactif, une commande d'un conteneur
docker start ID-archlinux
docker exec -it ID-archlinux /usr/bin/bash
exit
docker ps
# Note: le conteneur roule toujours car 'exec' s'exécute dans une file différente.

# Renommer un conteneur
docker rename [name-archlinux|ID] nouveauNom

# Effacer un conteneur
docker rm ID-conteneur

# Effacer une image
docker rmi ID-Image

# Exécuter un conteneur avec une fusion de ports IP
docker run -d --name web1 -p 80:80 nginx
docker run -d --name web2 -p 81:80 nginx
# Tester le serveur web1
curl localhost:80

# Afficher les logs d'un conteneur
docker logs web1

# Afficher les statistiques des conteneurs - CRTL C pour quitter.
docker stats

# Lister le ID de tous les conteneurs d'une image
docker ps -a --filter="ancestor=nginx" 

# Lister le ID de tous les conteneurs dont le nom est comme:
docker ps -a -q --filter="name=web"

# Arrêter tous les conteneurs d'une image
docker stop $(docker ps -a -q --filter="name=web")

# Effacer tous les conteneurs d'une image
docker rm $(docker ps -a -q --filter="ancestor=nginx")

Étape 1 – Créer un nouveau dépôt sur hub.docker.com

Ici, nous nous apprêtons à créer un dépôt de conteneurs pour un projet à venir. Nous pourrons, par la suite, y archiver toutes les versions du projet.

1.0 – En utilisant votre compte personnel, connectez-vous à hub.docker.com

1.1 – Sélectionner l’item menu ‘Repositories, suivi de l’option ‘Create …’

1.2 – Renseigner les informations de départ du nouveau dépôt 420-4d4

Note: Que des caractères minuscules dans le nom.

1.3 – Consulter le sommaire du nouveau dépôt

Étape 2 – Personnaliser un conteneur à partir de l’image de nginx

Évidement, ne voulant pas avoir à programmer, à partir de rien, une serveur web 😉, nous allons bâtir notre fondation sur l’image de nginx.

2.1 – Créer un conteneur ´web01´ à partir de l’image nginx:latest

docker run -d --name web01 -p 80:80 nginx

2.2 – Se connecter au ‘shell’ du conteneur ‘web01‘

docker exec -it web01 /bin/bash

2.3 – Installer, dans le conteneur, l’éditeur de texte ‘nano‘

apt update
apt install nano

2.4 – Remplacer le contenu du fichier ‘/usr/share/nginx/html/index.html‘

rm /usr/share/nginx/html/index.html
nano /usr/share/nginx/html/index.html

2.5 – Par le code suivant:

<!DOCTYPE html>
<html>
<head>
<title>Bienvenue au cours 420-4D4</title>
<style>
    body {
        width: 35em;
        margin: 0 auto;
        font-family: Tahoma, Verdana, Arial, sans-serif;
    }
    h1 { color: #6f82bf;
        font-weight: normal;

}
</style>
</head>
<body>
<h1>Bienvenue au cours 420-4D4</h1>
<p>Si vous voyez cette page, c'est que tout va bien!</p>

<p>L'image docker est disponible avec 'docker pull VOTRECOMPTE/420-4d4:1.0'
<br/><br/>
Pour lancer le conteneur:<br/><br/><strong> docker run -it -d -p 80:80 --name serveurweb VOTRECOMPTE/420-4d4:1.0</strong><br>
<br/><a href="http://ve2cuy.com/420-4d4b/">Contenu du cours</a>.</p>

<p><em>Ceci est la version 1.0 de l'application<br/><br/>(c) Votre prénom nom - 2023</em></p>
</body>
</html>

2.6 – Quitter le ‘shell’ du conteneur et tester le serveur web:

exit

Note: L’exécution du conteneur ne sera pas arrêtée par cette opération, car nous nous sommes connectés avec la commande ‘exec‘

Étape 3 – Créer une image à partir du conteneur

À ce point, nous avons adapté un conteneur à nos besoins. Il est temps d’en faire une image qui pourra être, par la suite, distribuée à l’infini.

3.1 – Créer une image dont le nom est composé de votre nomDomaineDocker/nomDépôt:version(tag)

docker ps
docker commit web01 VOTRECOMPTE/420-4d4:1.0

3.2 – Vérifier la présence de la nouvelle image

docker images

3.3 – Connexion au compte hub.docker.com

Pour être en mesure de pouvoir publier notre nouvelle image sur hub.docker, il faut obligatoirement s’authentifier, à partir de votre fenêtre terminal ou, alternativement, via l’application ‘docker desktop’.

Voici comment y arriver:

docker login --username=VOTRECOMPTE
password: FOURNIRLEMOTDEPASSE (ou TOKEN)

Au besoin, il faut créer un « Access Token »

3.4 – Publier (push) l’image vers le dépôt 420-4d4 sur hub.docker.com

Maintenant que nous sommes authentifiés au dépôt docker il ne nous reste plus qu’à publier la nouvelle image en utilisant la commande suivante:

docker push VOTRECOMPTE/420-4d4:1.0

3.5 – Vérifier la présence de l’image sur votre dépôt hub.docker

4 – Tester l’image qui se trouve sur hub.docker.com

4.1 – Obtenir et exécuter l’application en utilisant le port 88

docker run -d -p 88:80 --name web-test VOTRECOMPTE/420-4d4:1.0

4.2 – Tester dans un fureteur

4.3 – Conclusion

Nous avons maintenant accès, à partir d’un dépôt hub.docker, à l’image personnalisée d’un serveur nginx, qui propose une page d’accueil sur mesure ainsi que l’éditeur de texte ‘nano‘.

Étape 5 – Stockage persistant

TRISTESSE – À chaque fois que nous recréons un conteneur à partir d’une image, nous retrouvons le système de fichiers dans son état de départ.

Cela pose un problème non négligeable lors des mises à jour de l’image.

Pour contrer cet état de fait, docker propose les stockages persistants.

Grace à une série d’exemples, voyons comment cela fonctionne.

5.1 – Créer un répertoire local pour les fichiers du site web

mkdir /home/alain/docker-folder/siteweb

5.2 – Créer le fichier info.html dans le répertoire de l’étape 5.1

&lt;center&gt;&lt;h1&gt;Vive le sirop d'&amp;eacute;rable ;-)&lt;/h1&gt;&lt;/center&gt;

5.3 – Démarrer un conteneur à partir de la syntaxe suivante:

docker run --name mon-nginx -v /home/alain/docker-folder/siteweb:/usr/share/nginx/html:rw -d -p 8080:80 nginx

# Sous Windows:
 docker run --name mon-nginx -v C:\Users\4204D4\semaine02:/usr/share/nginx/html:rw -d -p 8080:80 nginx

5.4 – Tester la page ‘info.html‘ dans un fureteur

http://localhost:8080/info.html

Wow, quelle merveilleuse page web ☺️ :

5.5 – Ajoutons un peu plus de substance à notre site web:

Dans un dossier de téléchargement, par exemple, : /home/$USER/download,

git clone https://github.com/creativetimofficial/bootstrap4-cheatsheet.git

5.6 – Déplacer l’app vers le dossier lié au conteneur:

mv bootstrap4/ /dossier/web/conteneur/bs

5.7 – Tester l’app – http://localhost:8080/bs/

Wow, vraiment làlà, une ~~merveilleuse~~ page web 👍:

Note: Nous n’avons pas à publier une nouvelle version de l’image de l’application. Les nouveaux contenus sont stockés localement.

Laboratoire

En utilisant votre compte hub.docker.com, créer un dépôt labo-01
Bâtir un conteneur personnalisé à partir de l’image apache officielle
Installer au besoin, dans le conteneur, les outils requis pour réaliser la tâche; apt update, apt install, …
Remplacer la page d’accueil par l’application web du bootstrap-cheat-sheet. L’application doit être installée dans le conteneur et non pas dans un dossier lié.
Tester le conteneur sur le port 8080 – le bootstrap-cheat-sheet doit s’afficher sans fournir de nom de dossier dans l’URL.
Corriger au besoin
Créer une image, à partir du conteneur personnalisé, sous le nom ‘VotrenomDomaineDocker/labo-01:latest‘
Publier l’image dans votre dépôt docker
Effacer l’image locale – rmi
Exécuter l’image à partir de votre dépôt docker.
Afficher la page d’accueil du serveur web