Formations — 1 037 leçons en français

Accueil › Spring Boot › Conteneuriser et déployer

Conteneuriser et déployer

En productionavance

Deux façons courantes de conteneuriser une application Spring Boot :

Sans Dockerfile, avec les Cloud Native Buildpacks :

mvn spring-boot:build-image

Cette commande construit une image directement à partir du build, sans écrire de Dockerfile : les buildpacks choisissent l'image de base, installent le JDK, et découpent automatiquement le résultat en couches.

Avec un Dockerfile multi-étapes, en s'appuyant sur le jar en couches :

FROM eclipse-temurin:21-jre AS build
COPY app.jar app.jar
RUN java -Djarmode=tools -jar app.jar extract --destination extracted

FROM eclipse-temurin:21-jre
COPY --from=build extracted/dependencies/ ./
COPY --from=build extracted/application/ ./
ENTRYPOINT ["java", "org.springframework.boot.loader.launch.JarLauncher"]

L'outil d'extraction des couches (et l'option -Djarmode=... exacte) a évolué au fil des versions de Spring Boot 3 : vérifiez la commande recommandée pour la version utilisée. Le principe reste stable : séparer les dépendances (qui changent rarement) du code applicatif (qui change à chaque build) en couches Docker distinctes, pour que le cache Docker ne reconstruise que ce qui a réellement changé.

En production, penser aussi à : configurer par variables d'environnement, activer l'arrêt gracieux (server.shutdown=graceful), exposer les sondes liveness/readiness pour l'orchestrateur, dimensionner la JVM avec -XX:MaxRAMPercentage, et ne jamais faire tourner le conteneur en root.

Les termes à connaître

spring-boot:build-image

Objectif Maven/Gradle qui construit une image de conteneur directement à partir du projet, sans écrire de Dockerfile, grâce aux Cloud Native Buildpacks. Les buildpacks détectent le type de projet, choisissent une image de base adaptée et découpent automatiquement le résultat en couches.

Jar en couches (layered jar)

Organisation du jar exécutable en groupes de fichiers (dépendances, dépendances « snapshot », ressources de l'application, classes de l'application) plutôt qu'en une archive monolithique. Un Dockerfile multi-étapes peut alors copier chaque groupe dans une couche Docker distincte, activé par défaut sur les projets récents ou via le plugin Spring Boot.

Dockerfile multi-étapes (multi-stage build)

Dockerfile qui enchaîne plusieurs étapes FROM : une étape de build (compilation, extraction des couches) dont seul le résultat utile est copié dans l'étape finale, plus légère. Évite d'embarquer l'outillage de build (JDK complet, Maven) dans l'image de production.

Arrêt gracieux (graceful shutdown)

Comportement où, à réception du signal d'arrêt, le serveur cesse d'accepter de nouvelles requêtes mais laisse les requêtes en cours se terminer, dans la limite d'un délai configurable (spring.lifecycle.timeout-per-shutdown-phase), avant de couper. Contrôlé par server.shutdown : graceful est la valeur par défaut depuis Spring Boot 3.4 ; avant, il fallait l'activer explicitement (le défaut était immediate).

Sondes liveness / readiness

Endpoints Actuator (/actuator/health/liveness et /actuator/health/readiness) interrogés par l'orchestrateur (Kubernetes typiquement) : liveness indique si l'instance doit être redémarrée, readiness si elle doit recevoir du trafic. Activés automatiquement dans un environnement Kubernetes détecté, ou forcés avec management.endpoint.health.probes.enabled=true.

-XX:MaxRAMPercentage

Option JVM qui dimensionne le tas en pourcentage de la mémoire détectée du conteneur, plutôt qu'en valeur fixe (-Xmx). Elle s'adapte automatiquement si la limite mémoire du conteneur change, contrairement à une valeur figée qui reste correcte ou non selon l'environnement de déploiement.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.