Utiliser Docker et VsCode pour vos projets Joomla!

Quand il nous est plus possible, ou pas possible, d'utiliser un serveur local, une solution existe pour jouer avec Joomla!

Docker est un logiciel qui vous permettra de cloisonner différents projets et de rendre vos projets ultra-simple d'installation et de modification.

Ici, nous allons voir comment étape par étape.

Avant toutes choses, je vous propose de créer un dossier parent. Pour moi c'est "Docker".

Dans ce dossier, il faut créer votre dossier "projet" qui ici aura le nom de "joomla_5-0-3".

Nous allons utiliser ici VsCode pour ouvrir votre projet et créer deux dossier et un fichier docker-compose.yml

Votre projet s'ouvrira dans un espace tout propre de VsCode.

Votre projet étant ouvert, et vide. Il faut créer deux dossiers et un fichier.

Il est possible d'utiliser directement les liens à droite du nom de votre projet pour créer les deux dossiers "db" et "site_joomla". Ils sont pour l'instant vides et je vous conseille de les déplier pour voir qu'ils sont bien et ce sera utile pour voir ce qu'il va se passer lors du déploiement de votre projet.

Puis toujours à la racine de votre projet, il faut créer un fichier du nom de "docker-compose.yml"

Pour télécharger et installer votre Joomla! dans un bon environnement, il faut bien paramétrer le fichier docker-compose.yml

Un ami nous propose tout plein de détails sur la bonne construction de ce fichier. La toute dernière version en bas du document sera notre base de travail.

Suivre le lien > Le blog de Christophe AVONTURE

Faite attention de toujours bien enregistrer vos modifications de fichier.

Pour nous permettre de télécharger la bonne version de Joomla que l'on souhaite. Il existe une ressource maintenue par Joomla.org

Suivre le lien > Le hub docker de Joomla!

Nous choisirons la version 5.0.3 qui nous intéresse 5.0.3-php8.1-apache

Nous devons personnaliser ce fichier en modifiant la ligne 3 pour name, la ligne 7 pour l'image de Joomla! que l'on souhaite utiliser, la ligne 12 en 80XX:80 si on a besoin d'ouvrir plusieurs containers en même temps.

Il est temps d'ouvrir son terminal. Pour ma part, je l'utilise directement dans VsCode.

C'est pour moi le plus simple, car nous l'ouvrons directement dans le bon dossier sans complexités.

Pour lancer la procédure de téléchargement est d'installation dans Docker, il nous faut utiliser la commande :

docker compose up --detach

Cette ligne nous sera utile également pour lancer des mises à jour que nous ferions depuis le fichier docker-compose.yml

Il est temps d'appuyer sur entrée votre curseur à droite de votre ligne de commande dans le terminal et de voir la magie s'opérer.

En patientant quelques secondes, vous y verrez différentes lignes se déployer dans le terminal et si vous regardez à gauche, dans la gestion des fichiers, tous les éléments de base de donnée et de Joomla! s'installent.

Il est temps pour nous d'aller dans Docker.

On peut y voir nos différents projets, rangé dans des containers.

Pour notre "Joomla503" on y retrouve l'environnement db et les fichiers Joomla!

Sur la droite la possibilité de mettre les containers en pause ou en lecture etc ... et au milieu le lien d'ouverture de notre Joomla! 8089:80. En cliquant cela nous ouvre directement notre navigateur pour installer Joomla!

Voilà la dernière difficulté, et encore tout est écrit dans le fichier docker-compose.yml

Le nom d'hôte de l'hébergement est : "joomladb", le nom d'utilisateur "root" et le mot de passe "example".

La suite est sans aucunes difficulté car identique sur toutes les installations de Joomla!

Vous voilà avec un Joomla! tout neuf, sans n'avoir téléchargé, dézippé, etc... quoi que ce soit !

C'est presque trop facile quand on commence à bien jouer avec ces deux environnements qui sont VsCode et Docker