Faire tourner plusieurs services avec Docker Compose

Faire évoluer Mini-Carnet pour utiliser Redis

Jusqu'ici, le compteur de visites vivait dans un fichier, protégé par un volume depuis le guide 18. Une application avec un vrai service annexe utilise plus souvent un stockage dédié comme Redis. Mettez à jour package.json pour ajouter cette dépendance :

package.json

{

"name": "mini-carnet",

"version": "1.0.0",

"main": "server.js",

"scripts": { "start": "node server.js" },

"dependencies": { "express": "^4.19.2", "redis": "^4.7.0" }

}

Et modifiez server.js pour stocker et lire le compteur dans Redis plutôt que dans un fichier :

server.js (mis à jour)

const express = require('express');

const { createClient } = require('redis');

const app = express();

const PORT = process.env.PORT || 3000;

const APP_NAME = process.env.APP_NAME || 'Mini-Carnet';

const REDIS_HOST = process.env.REDIS_HOST || 'redis';

const redisClient = createClient({ url: `redis://${REDIS_HOST}:6379` });

redisClient.connect();

app.get('/', async (req, res) => {

const visites = await redisClient.incr('visites');

res.send(`<h1>Bienvenue sur ${APP_NAME} 👋</h1><p>Visite n°${visites}</p>`);

});

app.listen(PORT, () => console.log(`${APP_NAME} est démarré sur le port ${PORT}`));

Remarquez la ligne REDIS_HOST = process.env.REDIS_HOST || 'redis' : l'application contacte Redis via un nom d'hôte, pas une adresse IP, exactement comme au guide 20. La valeur par défaut, redis, correspond au nom du service que vous allez déclarer juste en dessous.

Ajouter Redis dans compose.yaml

compose.yaml

services:

mini-carnet:

build: .

ports:

- "3000:3000"

environment:

APP_NAME: Carnet de Julie

depends_on:

- redis

redis:

image: redis:alpine

Un second service, redis, utilise directement image: redis:alpine plutôt que build : contrairement à Mini-Carnet, aucune construction n'est nécessaire, l'image officielle existe déjà. depends_on indique à Compose de démarrer redis avant mini-carnet, dans le bon ordre.

depends_on garantit l'ordre de démarrage, pas que le service soit prêt

depends_on garantit que le conteneur redis a démarré avant mini-carnet, pas que Redis a fini son initialisation interne et accepte déjà des connexions. Pour Redis, ce délai est en pratique quasi instantané, donc sans conséquence ici. Pour des services plus lents à démarrer, il existe des options plus précises dans la documentation officielle de Compose, hors du périmètre de ce parcours.

Reconstruire et tout relancer

Puisque server.js et package.json ont changé, l'image doit être reconstruite. Ajoutez simplement --build à la commande déjà connue :

terminal

$ docker compose up -d --build

✔ Container mini-carnet-redis-1 Started

✔ Container mini-carnet-mini-carnet-1 Started

Ouvrez http://localhost:3000 et rafraîchissez plusieurs fois : le compteur augmente, désormais stocké dans le conteneur Redis, contacté par son nom, sans le moindre docker network create tapé manuellement cette fois.

Ce que Compose vient de vous éviter

Comparez avec le guide 20 : là-bas, un réseau personnalisé devait être créé à la main avant de démarrer chaque conteneur avec l'option --network. Ici, rien de tout cela n'a été écrit explicitement, et pourtant Mini-Carnet joint Redis par son nom sans problème. Le guide suivant explique précisément ce que Compose a fait pour vous, en coulisses.

Vérifiez que vous avez compris

Vous supprimez la ligne depends_on du service mini-carnet, sans rien changer d'autre. Mini-Carnet va-t-il définitivement perdre la possibilité de contacter Redis par son nom ?

Non. depends_on influence uniquement l'ordre de démarrage des conteneurs, pas leur capacité à communiquer entre eux. La résolution de noms entre services d'un même fichier Compose fonctionne indépendamment de depends_on ; sans cette ligne, il est simplement un peu moins garanti que Redis ait déjà démarré au moment exact où Mini-Carnet tente sa première connexion.