Accueil › Java › La JVM dans un conteneur
La JVM dans un conteneur
Modules et déploiementavance
Avant Java 10 (et son rétroportage en Java 8u191), une JVM lancée dans un conteneur voyait les ressources de la machine hôte entière : un conteneur limité à 1 Go de mémoire sur un hôte qui en a 64 pouvait voir une JVM dimensionner son tas par défaut bien au-delà de sa limite réelle, menant à un arrêt brutal par le noyau. Depuis, -XX:+UseContainerSupport (activé par défaut) fait détecter à la JVM les limites CPU et mémoire des cgroups Linux du conteneur — cgroups v1 et v2 sont tous deux pris en charge depuis Java 15.
Cette détection change directement une pratique de dimensionnement : plutôt qu'un -Xmx512m fixe à réviser à chaque changement de limite mémoire du conteneur, -XX:MaxRAMPercentage=75.0 dimensionne le tas en pourcentage de la mémoire réellement détectée, et suit automatiquement l'environnement de déploiement.
FROM eclipse-temurin:25-jre
COPY app.jar app.jar
ENTRYPOINT ["java", "-XX:MaxRAMPercentage=70.0", "-jar", "app.jar"]
Trois points à ne pas négliger en conteneur : l'image de base (un JRE minimal ou une image jlink réduite pèse et démarre mieux qu'un JDK complet), l'arrêt propre sur SIGTERM (forme exec de CMD/ENTRYPOINT, pas la forme shell, pour que le processus java soit bien PID 1 et reçoive le signal), et la journalisation sur la sortie standard plutôt que dans des fichiers, pour rester compatible avec la collecte de logs de l'orchestrateur. Le démarrage à froid et le préchauffage du JIT sont traités dans le chapitre Performance.
Les termes à connaître
- -XX:+UseContainerSupport
Option JVM activée par défaut qui fait détecter à la JVM les limites CPU et mémoire imposées par les cgroups Linux du conteneur, plutôt que celles de la machine hôte. Introduite en Java 10 puis rétroportée en Java 8u191.
- -XX:MaxRAMPercentage
Option JVM qui dimensionne le tas maximal en pourcentage de la mémoire détectée du conteneur, au lieu d'une valeur fixe (
-Xmx). S'adapte automatiquement si la limite mémoire du conteneur change entre environnements, sans reconstruire l'image.- cgroups v1 / v2
Deux générations du mécanisme Linux de limitation de ressources (CPU, mémoire) utilisé par les conteneurs. La JVM détecte et prend en charge les deux depuis Java 15 (support rétroporté ensuite vers des versions LTS antérieures).
- Mémoire hors tas (off-heap)
Mémoire native utilisée par la JVM en dehors du tas dimensionné par
-Xmx/MaxRAMPercentage: metaspace, piles de threads, code compilé par le JIT, buffers directs (ByteBuffer.allocateDirect), structures internes du ramasse-miettes. Non comptée par les options qui dimensionnent seulement le tas.- OOMKilled
Terminaison d'un conteneur par le noyau Linux (OOM killer) ou l'orchestrateur quand sa consommation mémoire totale dépasse la limite fixée, indépendamment de l'état interne du tas Java. Se distingue d'une
OutOfMemoryErrorpropre levée par la JVM elle-même.- Arrêt propre sur signal
Comportement attendu d'un processus qui, à réception de SIGTERM, termine son travail en cours puis s'arrête de lui-même avant l'expiration du délai de grâce, plutôt que d'être tué abruptement (SIGKILL) par l'orchestrateur.
- Runtime.availableProcessors()
Méthode qui reflète, depuis la détection des cgroups, le nombre de processeurs alloués au conteneur (quota CPU), pas celui de la machine hôte. Une valeur historiquement source d'erreurs de dimensionnement (pools de threads,
ForkJoinPool.commonPool()) avant que cette détection n'existe.
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.