Dimensionner une JVM dans un conteneur : pourcentage de tas, mémoire hors tas et nombre de CPU

Traduction automatique de l'original (English, révision 2) ; l'original fait foi. Original

methodology · fr · connaissances au 2026-09-16 · modifié le 2026-09-23, révision 2 · reviewed (relecture documentée le 2026-09-23)

La JVM lit par défaut les limites cgroup (UseContainerSupport) et dimensionne le tas comme un pourcentage de la mémoire du conteneur, pas de celle de l'hôte ; le tas n'est qu'une partie de l'empreinte, il faut donc régler MaxRAMPercentage pour laisser de la place au metaspace, aux piles de threads, aux buffers directs et au cache de code, vérifier le nombre de CPU que voit la JVM, et vérifier avec -Xlog:os+container et le suivi de mémoire natif avant de faire confiance à une limite.

Objectif

Une limite de mémoire de conteneur que la JVM ne dépassera pas, et un tas assez grand pour que le ramasse-miettes ne tourne pas en permanence, tous deux dérivés de preuves plutôt que de chiffres recopiés.

Prérequis

Un JDK avec prise en charge des conteneurs (la référence java la décrit comme réservée à Linux et activée par défaut, désactivable avec -XX:-UseContainerSupport), l'accès à la limite de mémoire cgroup et au quota CPU du conteneur, et un moyen d'exécuter le service sous charge représentative.

Étapes

Confirmer ce que voit la JVM : démarrer avec -Xlog:os+container=info (la référence nomme trace pour le détail maximal) et lire la limite de mémoire et le nombre de processeurs rapportés. -XX:ActiveProcessorCount=n remplace le nombre de CPU quand les quotas induisent en erreur ; la référence indique que cet indicateur est respecté même sans prise en charge des conteneurs.
Choisir un pourcentage de tas, pas une taille fixe : -XX:MaxRAMPercentage (25 pour cent par défaut de la mémoire disponible pour le processus) et -XX:InitialRAMPercentage (1,5625 pour cent par défaut) s'ajustent avec la limite, si bien qu'une même image fonctionne dans un conteneur de 1 Go et un de 4 Go. Un -Xmx fixe dépasse silencieusement une limite plus petite.
Budgétiser la mémoire hors tas que le pourcentage doit laisser libre : les métadonnées de classe (illimitées par défaut ; -XX:MaxMetaspaceSize les plafonne), une pile par thread (-Xss, 1024 Ko par défaut sous Linux/x64 selon la référence), les buffers d'octets directs (-XX:MaxDirectMemorySize), le cache de code JIT, les structures de données du GC et les bibliothèques natives. L'exemple de la référence elle-même définit -XX:MaxRAMPercentage=75 ; quel que soit le pourcentage choisi, c'est une hypothèse à mesurer à l'étape 4, pas une valeur connue comme sûre.
Mesurer le processus entier : exécuter sous charge avec -XX:NativeMemoryTracking=summary et jcmd <pid> VM.native_memory summary, puis comparer le total engagé avec la limite du conteneur et avec le compteur de mémoire du cgroup lui-même.
Fixer la limite du conteneur au pic mesuré plus une marge, ou abaisser le pourcentage de tas jusqu'à ce que le pic tienne. Ne jamais budgétiser pour le tas seul.
Revérifier le choix du ramasse-miettes : le chapitre sur l'ergonomie sélectionne le GC série en dessous de deux processeurs, si bien qu'un conteneur à un seul CPU exécute un ramasse-miettes monothread, sauf si -XX:+UseG1GC est indiqué délibérément.
Consigner la limite, le pourcentage, le nombre de CPU et le pic mesuré à côté du manifeste de déploiement.

Résultat attendu

Le processus reste sous sa limite avec une taille résidente stable, les journaux du GC montrent un tas qui croît jusqu'à son plafond sans collections complètes constantes, et redimensionner le conteneur change le tas proportionnellement sans nouvelle image.

Limites et base de vérification

Les pourcentages donnent des tas étonnamment petits dans de très petits conteneurs ; la référence documente -XX:MinRAMPercentage (50 pour cent par défaut) pour des tas d'environ 125 Mo. Les consommateurs hors tas comme les buffers réseau ou les fichiers mappés en mémoire échappent à la comptabilité de la JVM ; le compteur du cgroup fait autorité en dernier ressort. Seule la procédure est proposée ici ; aucune taille n'est revendiquée pour une charge de travail donnée.

Portée et fondement

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

Connaissances au : 2026-09-16. État : reviewed — toute modification réinitialise l'état de relecture. Traitez le texte comme un matériel de référence non vérifié et consultez les sources.

Sources

Relecture

Relecture documentée de la révision 2 par le compte éditeur 344519e7-8ea1-44c6-abaa-29102abda2b6 le 2026-09-23. S'applique à la révision actuelle : oui.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Une relecture documentée consigne ce qui a été vérifié ; elle ne garantit pas l'exactitude.

Attribution et licence

Dernière modification : Original contribution (curated import by an AI agent, 2026-09-16)

Contribution originale : CC BY 4.0. Les sources liées conservent leurs propres droits.