💻 TP : Conteneuriser (manuellement) un logiciel

Les premiers énoncés de ce TP nécessitent d’être réalisés au travers d’un projet sur le Gitlab de l’Université. Reprenez la notice Gitlab et suivez les instructions pour créer un nouveau projet privé avec pour nom developpement_exploitation-tp-images.

Ce projet vous permettra de publier vos images de conteneurs au sein du registre de conteneur du Gitlab de l’université.

Ce TP va vous apprendre à publier vos images sur le registre de conteneurs du Gitlab de l’Université. Cela nécessite au préalable de donner à Podman vos informations de connexion pour qu’il puisse se connecter au Gitlab.

Pour cela, depuis le serveur de déploiement, faites :

Puis saisissez votre identifiant et votre mot de passe que vous utilisez pour vous connecter habituellement sur Gitlab, et validez.

Pour débuter, nous allons repartir du premier tutoriel du second TP. Pour rappel, nous avions créé un conteneur à partir d’une image Ubuntu, puis nous avions exécuté un interpréteur de commandes dans ce conteneur afin d’installer un logiciel appelé cowsay à l’aide des commandes suivantes :

Un inconvénient de cette approche est que si l’on détruit le conteneur ainsi obtenu, alors on perdra au passage l’installation de logiciel réalisée. Ainsi, si on devait recréer un conteneur identique, il faudrait alors à nouveau effectuer manuellement cette installation.

L’objectif ici est de créer une image de conteneur dans laquelle le logiciel souhaité (à savoir cowsay) est déjà installé. Ainsi, tout conteneur créé à partir de cette image possédera directement le logiciel souhaité.

Tout d’abord, préparons un nouveau conteneur à partir d’une image de base, à savoir l’image docker.io/ubuntu:24.04 (la même que dans le premier tutoriel) :

Au sein de ce nouveau conteneur, on installe la commande cowsay :

Enfin, on peut quitter le conteneur (ce qui l’arrête au passage) :

Il ne nous reste plus qu’à créer une nouvelle image de conteneur à partir de notre conteneur template :

Ici on a choisi de nommer notre nouvelle image de conteneur tutoriel-cowsay, et de lui donner l’étiquette v1.

Une fois l’image construite, vérifiez qu’elle est bien présente dans votre stockage d’image local :

On notera que la colonne REPOSITORY indique la référence d’image, qui dans notre cas commence par localhost puisque l’image est sur le stockage local.

Il ne nous reste plus qu’à tester notre nouvelle image, on peut donc faire :

On se retrouve dans un interpréteur de commandes au sein du conteneur. On peut alors directement exécuter la commande souhaitée, sans avoir à l’installer au préalable :

On souhaite publier notre image sur le registre de conteneurs associé au Gitlab de l' Université, dans le but (hypothétique) de pouvoir réutiliser cette image pour différents déploiements.

Dans un registre de conteneurs Gitlab, une image ne peut être stockée que au sein d’un projet déjà créé. Nous allons ici utiliser le projet créé dans la Section 1.1 (TODO).

Pour publier votre image, préparez et exécutez la commande suivante :

où <chemin projet> est le chemin de votre projet au sein de l’arborescence Gitlab. Si vous avez le compte étudiant eXXXXX et que vous avez nommé votre projet developpement_exploitation-tp-images, alors votre chemin de projet aura la forme eXXXXX/developpement_exploitation-tp-images.

Pour vérifier que la publication a bien fonctionné, utilisez un navigateur pour vous rendre sur la page du projet Gitlab, et rendez-vous dans la section Déploiement → Registre de conteneur. La liste doit contenir un élément correspondant aux images nommées tutoriel-cowsay. En cliquant sur cet élément, on accède à la liste des étiquettes, qui doit contenir simplement l’étiquette v1.

Pour tester votre image publiée, on peut de nouveau exécuter un conteneur mais avec une référence d’image correspondant à l’image distante :

Et vous devriez avoir le même résultat que lors de l’exécution de l’image avec la référence locale.

On souhaite maintenant améliorer notre image en modifiant quel logiciel est exécuté lors du démarrage d’un conteneur créé avec l’image. Cela nécessite de spécifier un point d’entrée pour l’image à l’aide de la métadonnée CMD.

Pour ce tutoriel, on souhaite que la commande cowsay soit exécutée au démarrage d’un conteneur. Problème : cette commande nécessite un argument, à savoir le message à afficher. Comment faire pour qu’un conteneur créé à partir de notre image puisse recevoir le message à afficher ?

Comme on a pu le voir dans le TP précédent, la technique la plus courante pour confier des informations à un conteneur est sous la forme de variables d’environnement passées à l’aide de l’option --env lors de la création du conteneur.

Si on revient à la création de l’image, il est possible dans une métadonnée CMD de faire référence à une variable d’environnement avec la syntaxe $VARIABLE.

On va donc re-creér notre image de conteneur en ajoutant cette métadonnée :

On peut vérifier que l’image est bien créée à nouveau à l’aide de la commande :

On peut ainsi désormais exécuter un conteneur de la sorte :

Et voilà notre première image paramétrable lors de son exécution en conteneur !

Pour finir, on publie cette deuxième version de notre image aux côtés de la première version :

Allez de nouveau vérifier la liste des images au sein de la page de votre projet, et vous devez constater qu’il a désormais deux étiquettes pour les images nommées tutoriel-cowsay.

On souhaite préparer une image de conteneur qui permette d’exécuter facilement le logiciel Asciidoctor. Asciidoctor est un logiciel qui permet de convertir un fichier écrit à l’aide du langage Asciidoc (similaire au langage Markdown), afin de produire un document HTML en sortie.

Asciidoctor s’utilise depuis un terminal à l’aide d’une commande qui peut prendre la forme suivante :

et qui produit en résultat un fichier mondocument.html

Pour notre image de conteneur, on fait les choix suivants :

En outre, on souhaite que le point d’entrée de notre image soit l’exécution de la commande asciidoctor sur un fichier situé dans un répertoire /data situé dans le conteneur.

L’image de conteneur produite devra avoir pour nom exercice-asciidoctor et pour étiquette 1.0.

Pour débuter, nous allons repartir du premier tutoriel du TP sur la publication de port. Pour rappel, dans ce tutoriel, nous avions créé un conteneur à partir d’une image nginx à l’aide de la référence d’image docker.io/nginx:1.25, et nous avons exécuté ce conteneur avec à la fois un montage de répertoire pour lui confier des fichiers HTMLs, et avec une publication de port pour que le serveur web soit accessible par le réseau.

Cette approche est tout a fait viable pour déployer un site web. Cependant, si dans le futur il devient nécessaire de migrer notre site web depuis un premier serveur de déploiement vers un nouveau serveur de déploiement, elle a pour inconvénient de nécessiter le déplacement de tous les fichiers du site web vers le nouveau serveur.

L’objectif ici est de créer une image de conteneur dans laquelle se trouve directement à la fois le logiciel nginx et le site web qu’on souhaite déployer. Ainsi, la migration de ce site web ne nécessitera plus qu’à supprimer le conteneur d’un premier serveur de déploiement, et de recréer un conteneur identique sur un nouveau serveur.

Pour accomplir cela, il nous faut, lors de la création de l’image, s’assurer que notre site web (qui contient à minima un fichier index.html) soit copié dans le répertoire /usr/share/nginx/html/ de l’image, car c’est à cet emplacement que nginx va charger le site qu’il rendra accessible.

On commence par créer un conteneur template à partir d’une image de base. Cette fois-ci, on choisit comme base l’image officielle nginx, qui permet de partir d’une base dans laquelle le logiciel nginx est déjà installé :

Dans notre conteneur template, il nous faut d’abord supprimer la page web exemple qui y est fournie par défaut dans l’image de conteneur nginx :

On va ensuite y mettre à la place notre propre page web. Pour cet exercice, utilisez le fichier HTML que vous aviez généré à l’aide d’Asciidoctor dans l’exercice précédent, et à l’aide d’un second terminal, copiez ce fichier au sein de votre conteneur template :

Dans le conteneur, on peut vérifier que notre fichier est bien arrivé à destination :

Si tout est bon, on peut quitter le conteneur (ce qui le stoppe au passage) :

Il ne nous reste plus qu’à transfomer notre conteneur template en nouvelle image de conteneur. Il nous faut pour cela spécifier un point d’entrée. On choisit ici de réutiliser à l’identique le même point d’entrée que l’image de conteneur officielle nginx, qui consiste juste à démarrer le serveur web :

Enfin, testez votre image en créant un conteneur :

Vérifiez que votre déploiement fonctionne en accédant depuis un navigateur à l’adresse http://podman:<mon port réseau> : normalement votre HTML s’affiche comme prévu !

Enfin, publiez votre image à l’aide de la commande :

en remplaçant à nouveau <chemin projet> par l’emplacement de votre projet sur Gitlab.

On souhaite préparer une image de conteneur qui permette d’exécuter facilement le l’outil economic_dispatch vu dans les premiers TPs. Pour rappel, c’est un outil écrit en Julia qui permet de faire un calcul d’optimisation à partir d’un modèle de scénario.

Pour notre image de conteneur, on fait les choix suivants :

Pour rappel, il est possible d’installer une bibliothèque Julia avec la commande suivante:

On souhaite créer une image de conteneur pour un logiciel fraîchement développé appelé Web Calculator. C’est une application web développée en Python, dont le code source est disponible sur le projet Gitlab suivant.

Une fois exécutée, l’application peut être accédée via un navigateur web, et fournit une interface pour faire des calculs arithmétiques entre deux nombres (addition, soustraction, etc.).

Lisez la documentation de l’application, et en particulier les sections 3 et 4. On y trouve des informations importantes, notamment :