Conteneurs — Création d’images

Docker & OCI

Emmanuel BRUNO

emmanuel.bruno@univ-tln.fr

Université de Toulon

LIS UMR CNRS 7020

2026-11-02

Objectifs

À la fin de ce cours, vous saurez :

• Comprendre la structure d’une image OCI
• Créer une image manuellement (et pourquoi éviter)
• Construire une image avec un Dockerfile
• Utiliser ENTRYPOINT et CMD
• Optimiser avec les builds multi-étapes
• Publier et analyser une image

Images de conteneurs (OCI)

Une image suit la spécification OCI (Open Container Initiative).

• Ensemble de couches en lecture seule
• Chaque couche = delta par rapport à la précédente
• Métadonnées séparées (CMD, ENV, labels…)
• Nom d’image formel — syntaxe générale : [[registry/][namespace/]repository[:tag][@digest]].
  • repository : partie obligatoire qui identifie le dépôt (nom du répertoire).
  • registry : hôte du registre (optionnel); si absent on entend en pratique le registre Docker Hub (docker.io).
  • namespace : segment optionnel pour regrouper les dépôts (sur Docker Hub, l’espace library est implicite pour les images officielles).
  • tag : référence optionnelle lisible (ex. :latest, :1.2.3); si aucun tag n’est fourni, latest est couramment utilisé comme valeur par défaut pour l’usage, mais l’absence de tag signifie que l’image peut aussi être désignée par un digest.
  • digest : identifiant immuable optionnel (forme sha256:<hex>); lorsqu’il est présent (@digest) il prend la priorité sur le tag pour désigner de façon exacte une image. (Les parties entre crochets [] sont optionnelles selon la spécification de référence des images.)

➡️ Une image n’est pas un conteneur mais le modèle de fichier utilisé pour en créer un ou plusieurs.

Exemple : Ubuntu

• pull commande pour récupérer une image depuis un registry
  • Les registries sont des dépôts d’images (Docker Hub, GitHub Container Registry, etc.)
• Image officielle Ubuntu : ubuntu:jammy
• Basée sur plusieurs couches empilées

docker pull ubuntu:jammy

jammy: Pulling from library/ubuntu
Digest: sha256:076e7bf82319619f28dd0aa9c02ab34b055ad37100395b4f49a2ffba04fb5e11
Status: Downloaded newer image for ubuntu:jammy
docker.io/library/ubuntu:jammy

• Liste des couches

docker history ubuntu:jammy

IMAGE          CREATED      CREATED BY                                      SIZE      COMMENT
a7b0f6af3254   7 days ago   /bin/sh -c #(nop)  CMD ["/bin/bash"]            0B        
<missing>      7 days ago   /bin/sh -c #(nop) ADD file:ba52f9eec2a5a7de7…   78.1MB    
<missing>      7 days ago   /bin/sh -c #(nop)  LABEL org.opencontainers.…   0B        
<missing>      7 days ago   /bin/sh -c #(nop)  ARG LAUNCHPAD_BUILD_ARCH     0B        
<missing>      7 days ago   /bin/sh -c #(nop)  ARG RELEASE                  0B        

• dans docker history (même après un pull)
  • Docker ne peut pas afficher l’ID d’une couche.
    • l’historique stocké dans l’image ne contient pas toujours les IDs des couches,
    • ou Docker n’a pas conservé ces couches dans son cache local.

Architecture en couches

Avantages :

• Mutualisation des couches communes
• Réduction de l’espace disque
• Téléchargement incrémental
• Cache efficace lors des builds

Création manuelle d’une image

Méthode possible mais déconseillée :

1. Lancer un conteneur
2. Modifier le système de fichiers
3. Valider avec docker commit

• ❌ Non reproductible
• ❌ Historique opaque
• ❌ Mauvaise pratique en production

Exemple : installer Git manuellement

• Lancer un conteneur Ubuntu : docker run --name my-ubuntu --interactive ubuntu:jammy bash

• Installer Git en interactif : apt-get update && apt-get install -y git

• Valider l’image et supprimer le conteneur intermédiaire.

docker commit my-ubuntu mygit:latest
docker rm my-ubuntu

sha256:b100ba6e81afe1c5e1f1297c103f692333d47c02a3c8eb7a8ddd55386c0a2baa
my-ubuntu

• Une nouvelle image mygit:latest est créée.

docker run --label teaching-demo=true --rm mygit git --version

git version 2.34.1

• Historique de l’image mygit.

docker history mygit

IMAGE          CREATED         CREATED BY                                      SIZE      COMMENT
b100ba6e81af   3 seconds ago   bash -                                          157MB     
a7b0f6af3254   7 days ago      /bin/sh -c #(nop)  CMD ["/bin/bash"]            0B        
<missing>      7 days ago      /bin/sh -c #(nop) ADD file:ba52f9eec2a5a7de7…   78.1MB    
<missing>      7 days ago      /bin/sh -c #(nop)  LABEL org.opencontainers.…   0B        
<missing>      7 days ago      /bin/sh -c #(nop)  ARG LAUNCHPAD_BUILD_ARCH     0B        
<missing>      7 days ago      /bin/sh -c #(nop)  ARG RELEASE                  0B        

➡️ Une seule couche opaque ajoutée

Dockerfile (méthode recommandée)

• Fichier texte avec instructions pour construire une image

Avantages :

• Reproductible
• Versionnable (Git)
• Automatisable
• Lisible

# Exemple simple
FROM ubuntu:jammy
RUN apt-get update && apt-get install -y git
ENTRYPOINT ["git"]
CMD ["--version"]

Dockerfile — Structure de base

Les exemples suivants sont accessibles dans le dépôt :

✅ : ebpro/sample-containers-python-helloworld

Détails

• URL: https://github.com/ebpro/sample-containers-python-helloworld
• Branch: develop
• Local Path: /home/jovyan/work/github/ebpro/sample-containers-python-helloworld
• Latest Commit: 9f358d3 - chore: add _quarto-utils submodule + .devcontainer (SOTA pattern)
• Timestamp: 2026-11-02T07:25:20Z

Clone Command:

git clone -b develop https://github.com/ebpro/sample-containers-python-helloworld

/home/jovyan/work/github/ebpro/sample-containers-python-helloworld
├── Dockerfile
├── Dockerfile.stage
├── README.md
├── _quarto-utils
├── hello.py
└── requirements.txt

2 directories, 5 files

Dockerfile

Dockerfile : Elements de base

• FROM : Image de base (ex: python:3.9).
• WORKDIR : Définit le dossier de travail (ex: /app).
• COPY : Copie les fichiers locaux dans l’image.
• RUN : Exécute des commandes : (ex. Installe les dépendances, pip install).
• ENTRYPOINT et CMD : Définit la commande par défaut.

Build d’une image et exécution

• Commande docker image build
• Contexte de build : répertoire avec Dockerfile ici .
  • .dockerignore exclure des fichiers du contexte de build ce qui accélère et sécurise la construction,

docker image build -t mon-app:0.0.1 .

docker run --label teaching-demo=true --rm mon-app:0.0.1

2026-11-02 07:25:54,194 INFO Hello John Doe, I'm Python running inside a container!
2026-11-02 07:25:54,194 INFO Here is your DataFrame:
     Name  Age
0  Pierre   22
1    Paul   35
2   Marie   58

Gestion des tags 1/2

Bonnes pratiques :

• Option --tag / -t pour nommer l’image
• Tag multiples pour une même image avec versionnage sémantique (semver) :
  • Versions complètes : 1.2.3
  • Versions majeures : 1, 1.2
  • Alias : latest
• Format : [registry/][namespace/]repository:tag

Gestion des tags 2/2

Tag à la construction (--tag / -t) :

docker image build \
  --tag helloworld:0.0.1 \
  .

Tag additionnels (docker tag) :

• Gestion des versions plus ‘large’
• Ajout d’un compte sur un registry pour partage :
  • ${DOCKERHUB_USERNAME} = votre nom d’utilisateur Docker Hub (ou autre registry)

docker image tag helloworld:0.0.1 \
  docker.io/${DOCKERHUB_USERNAME}/helloworld:0

docker image tag helloworld:0.0.1 \
  docker.io/${DOCKERHUB_USERNAME}/helloworld:0.1

docker image tag helloworld:0.0.1 \
  docker.io/${DOCKERHUB_USERNAME}/helloworld:0.0.1

docker image tag helloworld:0.0.1 \
  docker.io/${DOCKERHUB_USERNAME}/helloworld:latest

Utilisation de l’image

• Commande docker run
• -e / --env pour variables d’environnement dans le conteneur

docker run --label teaching-demo=true --rm docker.io/${DOCKERHUB_USERNAME}/helloworld

2026-11-02 07:26:01,579 INFO Hello John Doe, I'm Python running inside a container!
2026-11-02 07:26:01,579 INFO Here is your DataFrame:
     Name  Age
0  Pierre   22
1    Paul   35
2   Marie   58

docker run --label teaching-demo=true --rm -e NAME=Pierre docker.io/${DOCKERHUB_USERNAME}/helloworld:0.0.1

2026-11-02 07:26:05,274 INFO Hello Pierre, I'm Python running inside a container!
2026-11-02 07:26:05,274 INFO Here is your DataFrame:
     Name  Age
0  Pierre   22
1    Paul   35
2   Marie   58

Exercice 1 — Une Image Docker simple

Faire l’exercice :

Pratique Container Image — Exercice 1

Publication sur un registry

Étapes :

1. (Une fois) :

• création d’un compte (docker hub ou autres)
• connexion : docker login

1. Build + Tag correct (registry + namespace (nom d’utilisateur)).
2. Poussez les tags (docker push)

docker push docker.io/${DOCKERHUB_USERNAME}/app:latest

HEALTHCHECK

L’instruction HEALTHCHECK permet de définir une commande pour vérifier la santé d’un conteneur en cours d’exécution. Docker exécute périodiquement cette commande et utilise son code de retour pour déterminer l’état du conteneur : 0 (sain), 1 (non sain) ou 2 (réservé).

Exemple :

HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
  CMD curl --max-time 30 -f http://localhost/ || exit 1

Options principales :

• --interval: fréquence de vérification (ex. 30s).
• --timeout: délai maximum d’exécution de la commande (ex. 3s).
• --start-period: délai initial avant la première vérification (ex. 5s).
• --retries: nombre d’échecs consécutifs avant de considérer le conteneur comme non sain.

Les HEALTHCHECK sont utiles pour l’orchestration (restart policies, load balancers) et pour détecter des services défaillants.

ENTRYPOINT vs CMD

• Pour définir le comportement par défaut d’une image
  • Une image peut définir un ENTRYPOINT et un CMD
• ENTRYPOINT + CMD = commande complète
• Si CMD absent, arguments passés à docker run sont ajoutés à ENTRYPOINT
• Si ENTRYPOINT absent, docker run utilise CMD ou les arguments passés

• ENTRYPOINT : commande principale
• CMD : arguments par défaut

Directive	Rôle
ENTRYPOINT	Comportement principal
CMD	Paramètres remplaçables

ENTRYPOINT ["git"]
CMD ["--version"]

docker run mygit
docker run mygit status

➡️ Image utilisable comme un programme

Formats pour ENTRYPOINT / CMD

• Exec form : ["executable", "param1"] (Recommandé : transmet les signaux OS comme SIGTERM).
• Shell form : executable param1 :
  • À éviter (l’exécutable devient un enfant de /bin/sh -c et ne reçoit pas les signaux d’arrêt, ce qui rend le docker stop lent).
  • Mais permet le globbing (*) et l’interpolation des variables SHELL
  • Solution : utiliser un script entrypoint.sh

Exercice 2 — ARG et ENV

Faire l’exercice :

Pratique Container Image — Exercice 1

Multi-stage build

Objectifs :

• Séparer build et runtime
• Réduire la taille finale
• Supprimer toolchains et sources

Fonctionnement :

• Plusieurs étapes FROM dans un Dockerfile
• Chaque étape peut copier des artefacts de l’étape précédente (COPY --from=...)
• L’étape finale est l’image résultante

Exemple multi-étapes (C)

[WARNING] Git operation failed with status code: 128 Les exemples suivants sont accessibles dans le dépôt :

❌ : ebpro/sample-containers-c

Détails

• URL: https://github.com/ebpro/sample-containers-c
• Branch: develop
• Local Path: /home/jovyan/work/github/ebpro/sample-containers-c
• Latest Commit: No commit information available
• Timestamp: 2026-11-02T07:28:37Z

Clone Command:

git clone -b develop https://github.com/ebpro/sample-containers-c

: 128

docker image build \
     --tag ${DOCKERHUB_USERNAME}/helloworld_c:0.0.1 \
     .

docker run --label teaching-demo=true --rm ${DOCKERHUB_USERNAME}/helloworld_c:0.0.1 Paul

2026-11-02 07:28:41,270 INFO Hello John Doe, I'm Python running inside a container!
2026-11-02 07:28:41,270 INFO Here is your DataFrame:
     Name  Age
0  Pierre   22
1    Paul   35
2   Marie   58

Résultat

• Chaîne de build est versionnable, reproductible (gcc, sources, etc. dans le Dockerfile)
• Image finale très légère (uniquement l’exécutable + libs)
  • Aucun compilateur présent
  • Sécurité accrue
  • Démarrage rapide

Exposition des ports

• EXPOSE dans le Dockerfile pour documenter les ports utilisés
• -p / --publish dans docker run pour mapper les ports
• Exemple : application web sur le port 80

Dans le Dockerfile :

EXPOSE 80

docker run -p 8080:80 myapp

EXPOSE ne publie pas le port, il documente seulement.

Exercice 3 — Multi-stage build

Faire l’exercice :

Pratique Container Image — Exercice 3

Sécurité — Bonnes pratiques

Principes essentiels pour réduire la surface d’attaque et rendre les images sûres :

• Images minimalistes : choisir des bases petites (Alpine, distroless) ou builder multi-étapes pour ne garder que l’exécutable final.
• Éviter les secrets dans l’image : ne jamais écrire de mots de passe/jetons dans les Dockerfile. Utiliser BuildKit secrets (--mount=type=secret) ou des volumes/variables d’environnement au runtime.
• Ne pas exécuter en root : définir un utilisateur non-root dans le Dockerfile.

RUN addgroup -S appgroup && adduser -S appuser -G appgroup
USER appuser

• Pinning & immutabilité : référencer des images par digest (@sha256:...) ou pinner les versions de paquets pour éviter des mises à jour non contrôlées.
• Nettoyage des artefacts : supprimer les caches d’installateurs et réduire le nombre de layers (ex. apt-get clean && rm -rf /var/lib/apt/lists/*).
• Scanner et vérifier : utiliser des scanners (ex. docker scan, trivy) et générer un SBOM. Ex : trivy image --severity HIGH,CRITICAL myimage:latest.
• Limiter les privilèges au runtime : appliquer des profiles seccomp/AppArmor, retirer les capacités inutiles (--cap-drop), monter le FS en lecture seule quand possible (--read-only).
• Ressources et isolation : définir limites mémoire/CPU et pids pour limiter l’impact d’un processus compromis.

Utilisateur non-root

RUN adduser -D appuser
USER appuser

Secrets avec BuildKit

• Attention : ne pas inclure de secrets dans l’image finale
  • JAMAIS dans ENV ni non plus dans ARG (persistants dans l’image)
  • Utiliser les secrets temporaires de BuildKit

FROM alpine:3.18

# Dépendance nécessaire
RUN apk add --no-cache curl

# ARG pour une valeur non sensible (ex : URL ou nom d'environnement)
ARG API_URL=https://example.com/secure-data

# Utilisation du secret via BuildKit
RUN --mount=type=secret,id=api_key \
    curl --max-time 30 -H "Authorization: Bearer $(cat /run/secrets/api_key)" \
    ${API_URL} -o /tmp/data.json

# On peut ajouter un step pour vérifier que le fichier existe
RUN test -f /tmp/data.json

CMD ["cat", "/tmp/data.json"]

docker build \
  --secret id=api_key,src=./api_key.txt \
  -t myapp:latest .

Multi-architecture (buildx)

• Construire pour plusieurs architectures (amd64, arm64, etc.)
• Utiliser docker buildx ou docker build --platform

#| echo: true
#| output: true
docker build \
  --platform linux/amd64,linux/arm64 \
  -t docker.io/${DOCKERHUB_USERNAME}/helloworld_c:0.0.1 \
  .

• ℹ️ Pour publier une image multi-architecture sur un registry, utiliser docker buildx build --push.

À retenir

• Une image ≠ un conteneur
• Dockerfile pour créer des images
• ENTRYPOINT définit le comportement
• CMD fournit des arguments par défaut
• Multi-stage sépare build et runtime
• push Publier sur un registry
• Toujours penser sécurité & reproductibilité