Créer le premier Compose

Progression d’apprentissage0 / 404

0 / 18 validations dans ce chapitre

Réinitialiser la progression

Faire grandir un unique fichier Compose à partir d’un seul service.

Dans ce chapitre : 6 étapes et 18 preuves de validation.

Étape 31 — Comprendre la frontière Dockerfile / Compose

Objectif. Tu sauras pourquoi les deux fichiers sont nécessaires.

État du projet avant cette étape. L’image mariadb:inception existe et aucun container de projet ne tourne.

Comprendre le changement

Le Dockerfile explique comment fabriquer une image. Compose expliquera quelles images fabriquer, avec quelles valeurs, quels volumes et quel réseau, puis créera leurs containers.

Exigence du sujet · pp. 5–6

Docker Compose est obligatoire et doit appeler les Dockerfiles du projet.

Faire une seule chose

Dessine deux colonnes : Dockerfile = construction de l’image ; Compose = configuration et cycle de vie des services. Place FROM et RUN à gauche, volumes et networks à droite.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

Je place FROM, RUN et COPY dans Dockerfile.Je place services, volumes et networks dans Compose.Je sais que Compose ne remplace pas le Dockerfile.

Question de soutenance — Compose remplace-t-il un Dockerfile ?

Non. Le Dockerfile construit une image ; Compose indique quelles images construire et comment lancer leurs containers.

Étape 32 — Créer la racine services

Objectif. Tu écriras le plus petit fichier Compose valide conceptuellement.

État du projet avant cette étape. srcs/docker-compose.yml est vide.

Comprendre le changement

services est la clé qui contiendra les programmes gérés. On ne déclare encore aucun volume, réseau ou secret.

Exigence du sujet · pp. 5–6

L’infrastructure doit être décrite dans docker-compose.yml sous srcs.

Faire une seule chose

Écris une seule ligne, complètement à gauche. YAML utilise des espaces et une indentation significative.

Fichiers ou emplacements concernés

• srcs/docker-compose.yml

À ÉCRIRE DANSFichier srcs/docker-compose.yml · première ligne

Copier

services:

Ce que fait chaque partie

1. services ouvre la table des services Compose.
2. Le deux-points indique qu’un contenu imbriqué arrivera ensuite.

Résultat attendu

Le fichier contient uniquement services:.

Si cela échoue

N’utilise aucune tabulation dans un fichier YAML.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

services est écrit au niveau le plus à gauche.Le fichier ne contient encore aucun service.Aucune tabulation n’est utilisée.

Question de soutenance — Compose remplace-t-il un Dockerfile ?

Non. Le Dockerfile construit une image ; Compose indique quelles images construire et comment lancer leurs containers.

Étape 33 — Déclarer le nom du premier service

Objectif. Compose connaîtra MariaDB sans encore savoir la construire.

État du projet avant cette étape. Le fichier contient services: sans enfant.

Comprendre le changement

mariadb est le nom DNS et logique du service. image fixe le nom de l’image utilisée. Comme l’image existe déjà, ce premier bloc peut la référencer avant d’ajouter build.

Exigence du sujet · p. 6

Chaque image doit porter le même nom que son service.

Faire une seule chose

Ajoute mariadb puis image avec deux niveaux d’indentation.

Fichiers ou emplacements concernés

• srcs/docker-compose.yml

À ÉCRIRE DANSFichier srcs/docker-compose.yml · contenu complet actuel

Copier

services:
  mariadb:
    image: mariadb:inception

Ce que fait chaque partie

1. Deux espaces placent mariadb sous services.
2. Quatre espaces placent image sous mariadb.
3. mariadb est le service ; mariadb:inception est l’image.

Résultat attendu

Un seul service nommé mariadb référence mariadb:inception.

Si cela échoue

Une indentation incohérente transforme la structure ; compare exactement les espaces.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

Le service s’appelle mariadb.L’image s’appelle mariadb avec le tag inception.Aucun deuxième service n’existe.

Question de soutenance — Compose remplace-t-il un Dockerfile ?

Non. Le Dockerfile construit une image ; Compose indique quelles images construire et comment lancer leurs containers.

Étape 34 — Ajouter le chemin du Dockerfile

Objectif. Compose pourra reconstruire l’image au lieu de dépendre d’un build manuel.

État du projet avant cette étape. Compose connaît le nom de l’image mais pas sa recette.

Comprendre le changement

build.context indique le dossier envoyé au builder. dockerfile indique le nom de la recette dans ce contexte. Le chemin est relatif au dossier srcs qui contient Compose.

Exigence du sujet · pp. 5–6

Les Dockerfiles doivent être appelés dans docker-compose.yml par le Makefile final.

Faire une seule chose

Ajoute seulement le bloc build sous image.

Fichiers ou emplacements concernés

• srcs/docker-compose.yml

À ÉCRIRE DANSFichier srcs/docker-compose.yml · sous image

Copier

    build:
      context: ./requirements/mariadb
      dockerfile: Dockerfile

Ce que fait chaque partie

1. build ouvre la configuration de construction.
2. context est relatif à srcs.
3. dockerfile désigne le fichier à lire dans ce contexte.

Résultat attendu

Le service possède maintenant image et build.

Si cela échoue

N’écris pas srcs/requirements ici : depuis le fichier Compose, le bon chemin commence par ./requirements.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

build est sous le service mariadb.context pointe vers requirements/mariadb.dockerfile vaut Dockerfile.

Question de soutenance — Compose remplace-t-il un Dockerfile ?

Non. Le Dockerfile construit une image ; Compose indique quelles images construire et comment lancer leurs containers.

Étape 35 — Faire lire le YAML par Compose

Objectif. Tu vérifieras le plan sans lancer de container.

État du projet avant cette étape. Le fichier décrit un service et son build.

Comprendre le changement

docker compose config parse le YAML et affiche le modèle normalisé. Cette commande ne démarre rien. Elle doit devenir ton premier réflexe après chaque modification Compose.

Repère pédagogique · Guide

Bonne pratique de validation du fichier Compose obligatoire.

Faire une seule chose

Valide le fichier puis vérifie que docker ps reste vide pour le projet.

À EXÉCUTER DANSDans la VM · racine du repository

Copier

docker compose -f srcs/docker-compose.yml config
docker ps --filter name=mariadb

Ce que fait chaque partie

1. -f indique le fichier situé sous srcs.
2. config valide et normalise.
3. docker ps confirme qu’aucun container n’a été créé.

Résultat attendu

La sortie normalisée contient mariadb, image et build ; aucun container n’est listé.

Si cela échoue

Une erreur de parsing indique la ligne YAML et vient souvent de l’indentation.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

config termine sans erreur.La sortie contient un seul service.Aucun container de projet n’a démarré.

Question de soutenance — Compose remplace-t-il un Dockerfile ?

Non. Le Dockerfile construit une image ; Compose indique quelles images construire et comment lancer leurs containers.

Étape 36 — Construire avec Compose

Objectif. Tu remplaceras la commande docker build manuelle par le plan du projet.

État du projet avant cette étape. Compose sait où se trouve le Dockerfile MariaDB.

Comprendre le changement

compose build mariadb suit exactement le contexte déclaré. La commande ne démarre toujours pas de container.

Exigence du sujet · p. 5

Le Makefile final devra construire les images en utilisant ce fichier Compose.

Faire une seule chose

Demande à Compose de construire seulement MariaDB puis affiche l’image associée.

À EXÉCUTER DANSDans la VM · racine du repository

Copier

docker compose -f srcs/docker-compose.yml build mariadb
docker compose -f srcs/docker-compose.yml images

Ce que fait chaque partie

1. build mariadb limite la construction au premier service.
2. images affiche l’association service/image connue de Compose.

Résultat attendu

Le build réussit et l’image mariadb:inception est associée au service.

Si cela échoue

context not found signifie que build.context ne correspond pas au chemin depuis srcs.

Prouver que c’est correct

Preuves de validation 0 / 3

Une case correspond à une preuve observée ou expliquée, pas simplement à une commande copiée.

Le build Compose réussit.Compose liste mariadb:inception.Je sais retrouver la recette appelée par Compose.

Question de soutenance — Compose remplace-t-il un Dockerfile ?

Non. Le Dockerfile construit une image ; Compose indique quelles images construire et comment lancer leurs containers.