Base de données dans Docker ou sur l'hôte ?
Faut-il conteneuriser PostgreSQL, MySQL ou Redis en production ? Découvrez pourquoi Docker est viable si vous maîtrisez les volumes, les sauvegardes et les limites mémoire.
La base de données doit-elle tourner dans Docker ou sur l'hôte ?
Faites tourner la base de données dans Docker. Pour une pile applicative sur un VPS unique, une instance conteneurisée de PostgreSQL, MySQL, MongoDB ou Redis est un choix de production standard, et le débat habituel à ce sujet est souvent mal posé. Un conteneur est un processus Linux isolé par des namespaces et des cgroups, et non une machine virtuelle ; il n'y a donc pas d'hyperviseur entre la base de données et le disque. Avec un bind mount ou un volume nommé local, les opérations de lecture et d'écriture s'effectuent directement sur le système de fichiers de l'hôte, exactement comme avec une installation via le gestionnaire de paquets.
Le coût réel est opérationnel. Quatre facteurs déterminent si cette configuration est viable ou vouée à l'échec : l'emplacement des données, les permissions sur le répertoire, la procédure de mise à jour majeure de version et la validation de vos sauvegardes par une restauration. Si ces points sont maîtrisés, le conteneur n'est qu'un détail technique. Dans le cas contraire, le conteneur sera le bouc émissaire de vos problèmes.
Cette logique s'applique à toute base de données serveur. Les exemples ci-dessous utilisent PostgreSQL, MySQL, MongoDB et Redis, et les spécificités propres à chaque produit sont mentionnées lorsqu'elles sont pertinentes.
Ce qu’un conteneur change réellement
Pas le chemin de stockage, tant que vous en montez un. Même kernel, même page cache, même système de fichiers.
Il existe un véritable piège de performance : le cas où vous ne montez rien. Sans volume, le répertoire de données est placé dans la couche inscriptible du conteneur, qui est un système de fichiers overlay superposé à l’image. Les écritures y sont plus lentes, et toute la couche est supprimée lorsque le conteneur est supprimé. C’est de là que vient le problème « ma base de données était vide ce matin ».
Ce qui change réellement :
- Le cycle de vie.
docker compose downdétruit le conteneur. Tout ce qui ne se trouve pas dans un volume est supprimé avec lui. - La version. Le tag de l’image correspond à la version. Il n’y a pas de
apt upgradeà l’intérieur d’un conteneur de base de données qui survive audocker compose pullsuivant. - Le calcul de la mémoire. Une limite cgroup est une limite stricte appliquée par le kernel, et la plupart des valeurs par défaut des bases de données ne s’y adaptent pas automatiquement. MySQL 9.3 ou version ultérieure lit la limite pour certains paramètres. MongoDB essaie de le faire pour son cache WiredTiger, mais sa propre documentation avertit que cela peut ne pas fonctionner dans certains cas. PostgreSQL et Redis ne le font pas.
- L’utilisateur. Le processus s’exécute avec un identifiant numérique d’utilisateur à l’intérieur du conteneur, qui ne possède peut-être aucun fichier sur votre hôte.
L’emplacement des données détermine tout
Il existe deux bonnes options et une erreur courante.
- Un volume nommé :
pgdata:/var/lib/postgresql/data. Docker crée le répertoire dans/var/lib/docker/volumes/<project>_pgdata/_data, et l’entrypoint de l’image définit le propriétaire au premier démarrage. C’est la réponse par défaut. - Un bind mount :
/srv/appname/pg:/var/lib/postgresql/data. Vous choisissez le chemin, donc vous devez gérer les permissions. - Aucun mount. Voir ci-dessus. Les données se trouvent dans le conteneur.
Le compromis complet mérite un article à part, et les bind mounts par rapport aux volumes nommés le présente. Pour une base de données, la règle simple est la suivante : utilisez un volume nommé, sauf si vous devez connaître précisément le chemin sur l’hôte. Si vous utilisez un bind mount, placez-le dans un emplacement stable comme /srv/appname/pg, plutôt que dans le répertoire du projet, où un git clean peut y accéder.
Soyez prudent avec le stockage réseau. Ne placez pas le répertoire de données d’une base de données sur NFS (network file system) ni sur un autre mount réseau dont vous n’avez pas testé le verrouillage et le comportement de fsync. PostgreSQL impose une exigence précise pour NFS : utiliser un mount avec l’option hard. Il recommande aussi fortement l’option d’exportation sync sur le serveur NFS, car sans elle, un fsync sur le client n’est pas garanti d’atteindre le disque du serveur. Les bases de données supposent qu’un fsync réussi signifie que les octets sont sur un stockage stable. Lorsque cette hypothèse est fausse, une corruption apparaît parfois plusieurs semaines plus tard.
Fixez le nom du volume avant qu'il ne disparaisse
Compose nomme un volume <project>_<volume>, et le nom du projet utilise par défaut le nom du répertoire. L'identité du volume dépend donc du nom d'un répertoire, ce qui est une chose que l'on modifie souvent sans y penser.
Déplacez /srv/app vers /srv/app-old, ou renommez la clé pgdata dans le fichier compose, et le prochain docker compose up -d créera un volume vide flambant neuf. Postgres y initialise un nouveau cluster. Le conteneur est sain, l'application démarre, et toutes les tables ont disparu. La bonne nouvelle est que l'ancien volume est toujours présent sur le disque sous l'ancien nom.
docker volume ls
docker volume inspect app_pgdataFixez les noms pour éviter que cela ne se produise. Définissez explicitement le nom du projet et le nom du volume :
name: myapp
services:
db:
image: postgres:17
volumes:
- pgdata:/var/lib/postgresql/data
volumes:
pgdata:
name: myapp_pgdataSi un volume orphelin contient déjà vos données, copiez-les après avoir arrêté la base de données :
docker compose stop db
docker run --rm -v app_pgdata:/from -v myapp_pgdata:/to alpine sh -c 'cp -a /from/. /to/'
docker compose start dbSi vous effectuez la copie pendant que la base de données est en cours d'exécution, vous obtiendrez une copie corrompue des fichiers en cours d'écriture. Arrêtez-la d'abord.
Propriétaire du répertoire de données
Les images officielles Postgres, MySQL et MongoDB exécutent leur serveur avec un identifiant utilisateur numérique sans privilèges : 999 pour leurs tags par défaut, et 70 pour les tags Postgres -alpine. Lorsque le conteneur démarre avec root, l’entrypoint modifie le propriétaire du répertoire de données pour cet utilisateur, puis abandonne ses privilèges. C’est pourquoi un bind mount vide fonctionne généralement du premier coup.
Tout échoue dès que vous définissez user: dans le fichier compose, car l’entrypoint n’a alors plus les privilèges nécessaires pour corriger quoi que ce soit. Postgres l’indique directement :
initdb: error: could not change permissions of directory "/var/lib/postgresql/data": Operation not permittedUn répertoire de données existant avec des permissions incorrectes produit un autre message. Il faut le reconnaître, car la correction consiste à utiliser chmod, et non chown :
FATAL: data directory "/var/lib/postgresql/data" has invalid permissions
DETAIL: Permissions should be u=rwx (0700) or u=rwx,g=rx (0750).L’entrypoint MongoDB corrige les propriétaires de la même manière. Cette erreur concernant le fichier de verrouillage signifie donc qu’il n’a pas pu le faire : généralement, user: est défini ou le mount refuse un chown exécuté par root :
Unable to create/open the lock file: /data/db/mongod.lock (Permission denied). Ensure the user executing mongod is the owner of the lock file and has the appropriate permissions.La correction consiste à attribuer le répertoire hôte à l’identifiant numérique, et non à un nom :
sudo chown -R 999:999 /srv/appname/pg
sudo chmod 700 /srv/appname/pg
ls -ldn /srv/appname/pgls -ldn affiche les nombres au lieu des noms et doit afficher 999 999. Pour une image Postgres -alpine, utilisez plutôt 70:70 et attendez-vous à obtenir 70 70. Le compte appelé postgres sur votre hôte et le compte appelé postgres dans l’image n’ont aucun lien : le kernel compare les nombres, et les noms sont résolus séparément de chaque côté. comment PUID et PGID associent les utilisateurs de l’hôte à un conteneur explique correctement cette correspondance. Avec Docker rootless ou le remapping des user namespaces, les nombres changent encore. Lisez donc les identifiants dans le conteneur en cours d’exécution au lieu de supposer qu’il s’agit de 999.
Les named volumes font disparaître tout ce problème au premier démarrage, car Docker crée un répertoire vide et l’entrypoint en devient propriétaire.
Mises à niveau : mise à niveau d’un paquet contre changement de tag d’image
Sur l’hôte, apt upgrade vous fait passer à une version mineure. Votre distribution ne fera pas passer une base de données à une version majeure sans vous prévenir. Lorsque vous choisissez de le faire, les deux ensembles de binaires peuvent être installés simultanément, ce qui est précisément nécessaire à pg_upgrade.
Dans un conteneur, le tag correspond à la version. Une mise à niveau consiste donc à modifier une ligne. Les mises à niveau mineures sont ainsi triviales, tandis que les mises à niveau majeures nécessitent une procédure.
Remplacez postgres:16 par postgres:17, exécutez docker compose up -d, et le conteneur s’arrête immédiatement :
PostgreSQL Database directory appears to contain a database; Skipping initialization
FATAL: database files are incompatible with server
DETAIL: The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.Rien n’est endommagé. Les nouveaux binaires refusent de lire l’ancienne structure du catalogue sur disque, qui change entre les versions majeures. Remettez le tag à postgres:16 et le conteneur redémarre. Cette possibilité de rollback est le seul véritable avantage que les conteneurs apportent pour les mises à niveau.
La procédure prise en charge consiste à effectuer un dump, puis une restauration. PostgreSQL préfère que le dump soit réalisé avec le client le plus récent. Exécutez-le donc depuis la nouvelle image, vers l’ancien serveur toujours en fonctionnement sur le réseau compose :
docker run --rm --network myapp_default -e PGPASSWORD="$POSTGRES_PASSWORD" \
postgres:17 pg_dumpall -h db -U postgres > /srv/backups/all.sql
ls -lh /srv/backups/all.sql
tail -n 2 /srv/backups/all.sqlLe fichier doit faire au minimum plusieurs dizaines de kilooctets et se terminer par une ligne contenant PostgreSQL database cluster dump complete. Un fichier de quelques centaines d’octets signifie que le dump a échoué et que vous êtes sur le point de supprimer inutilement un volume. Effectuez cette vérification avant seulement :
docker compose down
docker volume rm myapp_pgdata
# edit the compose file: image: postgres:17
docker compose up -d db
docker compose exec -T db psql -U postgres -f /dev/stdin < /srv/backups/all.sqlPrévoyez une modification supplémentaire au niveau de postgres:18. À partir de 18, l’image officielle stocke ses données dans un répertoire versionné sous /var/lib/postgresql (pour 18, /var/lib/postgresql/18/docker) et déclare son volume à /var/lib/postgresql. Un volume toujours monté sur /var/lib/postgresql/data provoque l’arrêt du conteneur avec une erreur commençant par Error: in 18+, these Docker images are configured to store database data. Lorsque vous passez à 18 ou à une version ultérieure, modifiez le montage pour utiliser pgdata:/var/lib/postgresql. Les chemins /var/lib/postgresql/data de cet article concernent les versions 17 et antérieures.
Les autres moteurs diffèrent :
- MySQL 8 met à niveau son propre dictionnaire de données au démarrage. Une simple augmentation du tag de version se limite donc généralement à un redémarrage. Consultez les notes de version avant de passer à une autre série de versions et effectuez un dump dans tous les cas.
- MariaDB attend que
mariadb-upgradesoit exécuté une fois le serveur démarré avec la nouvelle version. - MongoDB doit être mis à niveau une version majeure à la fois. Après chaque étape, définissez la version de compatibilité des fonctionnalités avant de poursuivre. Ignorer une version signifie que
mongodrefuse de démarrer et journalise une ligneUPGRADE PROBLEMindiquantfeatureCompatibilityVersion. À partir de MongoDB 7.0, la commande nécessite un flag de confirmation explicite :db.adminCommand({ setFeatureCompatibilityVersion: "8.0", confirm: true }). - Redis charge sans problème les fichiers de snapshot plus anciens, mais pas les plus récents. Une mise à niveau consiste donc à redémarrer, tandis qu’un downgrade peut échouer lors du chargement des données.
La règle générale est la suivante : un conteneur facilite le downgrade, mais ne simplifie pas la mise à niveau.
Pourquoi mon conteneur de base de données s’arrête-t-il avec le code 137 ?
Parce que le kernel l’a tué avec l’OOM killer, faute de mémoire. 137 correspond à 128 plus le signal 9.
docker compose ps --all
docker inspect myapp-db-1 | grep -i oomkilled
journalctl -k | tail -n 20docker compose ps --all affiche Exited (137). Sans --all, Compose liste uniquement les conteneurs en cours d’exécution. La base de données arrêtée n’apparaît donc tout simplement pas dans la sortie. La ligne inspect indique "OOMKilled": true, et le log du kernel contient une entrée correspondante :
Memory cgroup out of memory: Killed process 4711 (postgres) total-vm:2170416kBOOMKilled indique seulement qu’un OOM killer a arrêté un processus dans le conteneur. Le préfixe Memory cgroup out of memory indique que la limite du conteneur est en cause. Une pénurie de mémoire touchant tout l’hôte est enregistrée sous Out of memory: Killed process. Dans ce cas, la correction doit être appliquée sur l’hôte, pas dans le conteneur.
Voici le mécanisme. Il surprend souvent. Dans le conteneur, free et /proc/meminfo indiquent toujours la quantité totale de mémoire de l’hôte. Une limite cgroup ne modifie pas cette valeur. PostgreSQL ne dimensionne rien à partir de cette valeur : shared_buffers vaut 128MB par défaut. Toute valeur supérieure vient de vous ou d’un guide de tuning. Le paramètre innodb_buffer_pool_size de MySQL vaut également 128M par défaut. Le problème commence lorsque les paramètres sont dimensionnés à partir de la mémoire indiquée par la machine. La documentation de PostgreSQL recommande 25% de la mémoire du système comme valeur de départ pour shared_buffers. Sur un hôte doté de 16 GB et avec une limite de 2 GB, cette règle donne donc 4 GB. Le cgroup tue alors la base de données bien avant que l’hôte lui-même ne subisse une pression mémoire. Certains moteurs utilisent désormais la limite pour certaines valeurs par défaut. C’est le cas de MySQL 9.3 et des versions ultérieures. MongoDB l’utilise aussi pour son cache WiredTiger lorsqu’il parvient à la détecter. Aucun de ces moteurs ne dimensionne tous ses paramètres à partir de cette limite, et la documentation de MongoDB précise que la détection peut échouer. Une limite mémoire seule ne suffit donc pas. Vous devez également indiquer à la base de données la mémoire dont elle dispose :
- PostgreSQL : définissez
shared_bufferset faites attention àwork_mem.work_mems’applique à chaque opération de tri ou de hachage. Chaque connexion peut en exécuter plusieurs simultanément. Une valeur généreuse multipliée par cinquante connexions est donc la cause habituelle d’un conteneur qui meurt sous charge plutôt qu’au démarrage. - MySQL et MariaDB : définissez
innodb_buffer_pool_size, qui vaut 128M par défaut. Avec MySQL antérieur à 9.3, laissezinnodb_dedicated_serverdésactivé dans un conteneur. Ce paramètre dimensionne le buffer pool à partir de la mémoire de la machine, qui correspond alors à celle de l’hôte. À partir de 9.3, MySQL lit les limites du conteneur etinnodb_dedicated_serverles utilise pour son dimensionnement. Une taille explicite du buffer pool reste toutefois le choix le plus prévisible. - MongoDB : définissez explicitement la taille du cache WiredTiger. MongoDB utilise la limite du conteneur lorsqu’il parvient à la détecter (
hostInfola signale sous la formememLimitMB). Sa documentation précise toutefois que la détection peut échouer dans certains cas et recommande de définir--wiredTigerCacheSizeGBou--wiredTigerCacheSizePctà une valeur inférieure à la mémoire du conteneur. - Redis :
maxmemoryest illimité par défaut. Redis augmente donc sa consommation jusqu’à ce que le cgroup l’arrête. Définissezmaxmemoryà une valeur nettement inférieure à la limite du conteneur et choisissez unmaxmemory-policy.
Postgres signale également l’événement de son côté. Voici les deux lignes que vous trouverez dans le log :
LOG: server process (PID 123) was terminated by signal 9: Killed
LOG: terminating any other active sessions due to crash of another server processLa terminaison d’un backend force le redémarrage de tous les autres backends, car la mémoire partagée peut être incohérente. Cela provoque un déluge de connexions pour votre application. Ce n’est pas un événement discret. La section définir des limites mémoire dans Docker Compose explique la syntaxe et la différence entre mem_limit et la forme deploy.resources.
Rien de tout cela ne disparaît sur l’hôte. Le problème est déplacé. Sans cgroup, la base de données entre en concurrence avec tous les autres processus de la machine. L’OOM killer de l’hôte choisit alors une victime selon son score, qui peut être sshd. Une limite qui tue la base de données de manière prévisible est plus facile à exploiter qu’un OOM de l’hôte qui vous bloque l’accès.
Sauvegardes : dump à l'intérieur, sauvegarde à l'extérieur
Ne sauvegardez pas une base de données en cours d'exécution en copiant son répertoire de données. Une copie au niveau fichier effectuée pendant que le serveur écrit génère une copie incohérente (torn copy), et vous ne le découvrirez qu'au moment de la restauration.
Deux méthodes fiables : effectuez un dump avec l'outil natif de la base de données pendant qu'elle tourne et sauvegardez ce dump, ou arrêtez le conteneur et copiez le volume à froid.
docker compose exec -T db pg_dump -U postgres -Fc appdb > /srv/backups/appdb.dump
docker compose exec -T db mysqldump -u root -p"$MYSQL_ROOT_PASSWORD" --single-transaction --all-databases > /srv/backups/mysql.sql
docker compose exec -T db mongodump --archive --gzip --db appdb > /srv/backups/appdb.archive.gz
docker compose exec -T redis redis-cli BGSAVELe -T est important. Sans lui, docker compose exec peut attacher un terminal à la commande, et la couche terminal ajoute des retours chariot au flux de sortie. Un dump texte sera alors restauré avec des erreurs étranges et un dump binaire sera tout simplement corrompu. Cela échoue silencieusement au moment de la sauvegarde et bruyamment un mois plus tard.
--single-transaction fournit à mysqldump un snapshot cohérent des tables InnoDB sans verrouiller tout le serveur.
Ces commandes écrivent un fichier chacune. Ce ne sont pas un système de sauvegarde : il n'y a pas de rétention, pas de copie hors serveur, et pas de vérification. Confiez le répertoire de dump à un outil qui gère ces trois aspects, ce qui est l'objet de restic backups from a VPS. Sauvegardez /srv/backups, pas /var/lib/docker/volumes.
Ensuite, effectuez une restauration, car une sauvegarde que vous n'avez jamais restaurée n'est pas une sauvegarde :
docker compose exec -T db createdb -U postgres restore_test
docker compose exec -T db pg_restore -U postgres -d restore_test < /srv/backups/appdb.dump
docker compose exec -T db psql -U postgres -d restore_test -c '\dt'\dt devrait lister les tables de votre application. Un résultat vide, ou Did not find any relations., signifie que le dump n'est pas ce que vous croyez. Supprimez restore_test une fois terminé.
La commande qui supprime tout
docker compose down -v.
La commande down supprime les conteneurs et le réseau. L'option -v supprime également tous les volumes nommés déclarés dans ce fichier compose, ainsi que tous les volumes anonymes attachés à ces conteneurs. Il n'y a aucune confirmation et aucune possibilité d'annulation. C'est la méthode la plus courante de destruction d'une base de données auto-hébergée, et cela arrive généralement lors du dépannage d'un problème sans rapport, parce qu'une réponse sur un forum a conseillé de l'exécuter.
Quatre mesures permettent de réduire le rayon d'impact :
- Déclarez le volume de la base de données comme
external: true. Compose ne supprimera pas un volume dont il n'est pas propriétaire, donc-vne pourra pas l'atteindre. Vous le créez une seule fois avecdocker volume create myapp_pgdata. - Utilisez
docker compose stopetdocker compose startpour les redémarrages de routine. down contre stop dans Compose détaille ce que chaque commande supprime. - Conservez les dumps sur un chemin de l'hôte en dehors de tout volume géré par compose.
- Ne copiez jamais
-vprovenant d'une réponse de dépannage dans une stack qui contient des données importantes pour vous.
Ne publiez pas le port de la base de données
Cette ligne expose votre base de données sur l'internet public :
ports:
- "5432:5432"Elle lie le service à toutes les interfaces. Docker publie un port en réécrivant la destination du paquet avant que les règles d'entrée de votre pare-feu ne soient traitées. Comme les règles ufw se situent dans la chaîne input, ufw deny 5432 est sans effet. pourquoi les ports publiés par Docker contournent ufw détaille le parcours des paquets dans les chaînes.
Une application située dans le même projet compose accède à la base de données via le nom du service sur le réseau compose ; elle n'a donc pas besoin de port publié. Supprimez ce bloc. Si vous avez besoin d'un accès client depuis l'hôte, liez le service uniquement à l'interface de loopback :
ports:
- "127.0.0.1:5432:5432"Vérifiez quel service écoute réellement :
sudo ss -ltnp | grep 5432127.0.0.1:5432 est la configuration attendue. 0.0.0.0:5432 signifie que n'importe qui peut tenter de deviner votre mot de passe.
Où exécuter quoi
Une application sur un VPS. Utilisez un conteneur. Prévoyez un volume nommé avec un identifiant fixe, aucun port publié, une limite de mémoire adaptée aux réglages de la base de données, et un dump quotidien vers un chemin de l'hôte que restic récupère. Partez de une installation Docker propre sur un VPS et conservez la stack dans un fichier compose que vous versionnez. Le gain est réel : la version de la base de données devient une ligne vérifiable dans git.
Un hôte exécutant plusieurs services. Utilisez des conteneurs, avec une base de données par application, et non un serveur partagé pour l'ensemble. Un serveur partagé lie chaque application à un calendrier de mise à jour unique, et une requête incontrôlée devient une panne pour tout le monde. Attribuez à chaque conteneur sa propre limite de mémoire afin qu'une requête défaillante soit contenue dans l'application qui l'a générée. Plusieurs petites instances Postgres consomment un peu plus de disque mais demandent beaucoup moins de coordination.
La base de données est le cœur du produit. Exécutez-la sur l'hôte à partir du dépôt de paquets de l'éditeur, ou payez pour un service managé. pg_upgrade nécessite l'installation simultanée des deux versions majeures des binaires, ce que les paquets permettent contrairement à une image à version unique. La réplication et la restauration à un instant T avec l'archivage des WAL (write ahead log) sont plus simples lorsque la base de données possède la machine et ses disques. Choisissez la solution éprouvée pour le système qui vous alertera à 03:00.
L'application est légère. Envisagez de ne pas utiliser de serveur de base de données du tout. Une application web à écriture unique sur un VPS est souvent mieux servie par SQLite en production sur un VPS, où la sauvegarde se résume à un seul fichier et le chemin de mise à jour à une version de bibliothèque.
FAQ
Est-il sûr d’exécuter une base de données de production dans Docker ?
Oui, pour une stack applicative sur un seul serveur. Un conteneur est un processus Linux entouré de namespaces et de cgroups. Avec un volume monté, la base de données écrit donc dans le même système de fichiers de l’hôte que si vous l’aviez installée depuis un package. Les risques sont opérationnels, et non liés aux performances : un volume dont le nom n’est pas figé, un bind mount appartenant au mauvais user id, une restauration que vous n’avez jamais testée et docker compose down -v. Si vous éliminez ces quatre risques, le conteneur convient. Passez à une installation sur l’hôte lorsque la base de données constitue la charge principale et que vous avez besoin de pg_upgrade, de la réplication ou d’une récupération à un instant donné.
Dois-je utiliser un bind mount ou un volume nommé pour les données de la base ?
Utilisez un volume nommé, sauf si vous avez une raison précise de connaître le chemin sur l’hôte. Docker crée le répertoire et l’entrypoint de l’image définit son propriétaire au premier démarrage. Le problème de permissions ne se pose donc pas. Figez le volume avec un name: explicite ou marquez-le external: true. Sinon, renommer le répertoire du projet crée silencieusement un volume vide et une base de données vide. Un bind mount convient si vous faites un chown du répertoire de l’hôte avec l’identifiant utilisateur numérique utilisé par l’image. Il s’agit de 999 pour les tags par défaut des images officielles Postgres, MySQL et MongoDB, et de 70 pour les tags Postgres -alpine. Vérifiez-le avec ls -ldn, car ls -l affiche le nom utilisé par votre hôte pour ce numéro, et ce nom n’a aucune signification dans le conteneur.
Que supprime docker compose down -v ?
Comme un down simple, cette commande supprime les conteneurs et le réseau. -v supprime en plus chaque volume nommé déclaré dans ce fichier Compose, ainsi que chaque volume anonyme attaché à ces conteneurs. Cela inclut la base de données. Aucune confirmation n’est demandée et aucune récupération n’est possible. Les volumes marqués external: true ne sont pas supprimés. C’est la principale raison de marquer un volume de base de données comme externe. Pour un redémarrage courant, utilisez plutôt docker compose stop et docker compose start.
Comment mettre à niveau PostgreSQL vers une nouvelle version majeure dans Docker ?
Faites un dump, puis restaurez-le. Modifier postgres:16 en postgres:17 et redémarrer produit FATAL: database files are incompatible with server avec une ligne DETAIL indiquant les deux versions, car les nouveaux binaires ne peuvent pas lire l’ancien format du catalogue. Rien n’est endommagé : remettez l’ancien tag et la base redémarre. Créez un pg_dumpall avec le client de la nouvelle version, en l’exécutant contre l’ancien conteneur en fonctionnement. Vérifiez que le fichier se termine par PostgreSQL database cluster dump complete. Démarrez ensuite le nouveau tag sur un volume vide et chargez le dump. À partir de postgres:18, montez ce volume sur /var/lib/postgresql plutôt que sur /var/lib/postgresql/data. Les mises à niveau mineures au sein d’une même version majeure nécessitent seulement un pull et un redémarrage.
Pourquoi mon conteneur de base de données s’arrête-t-il avec le code 137 ?
137 correspond à 128 plus le signal 9. Un processus l’a donc tué immédiatement. Exécutez docker inspect <container> | grep -i oomkilled. Une valeur true signifie que l’OOM killer a terminé un processus dans le conteneur, généralement parce que le conteneur a atteint sa propre limite mémoire cgroup. La cause habituelle est une configuration mémoire dimensionnée pour l’hôte plutôt que pour le conteneur. Les outils du conteneur indiquent toujours la mémoire totale de l’hôte. Un buffer dimensionné pour 16 GB peut donc occuper l’espace disponible dans un conteneur limité à 2 GB. Définissez shared_buffers et work_mem, ou innodb_buffer_pool_size, afin de respecter la limite attribuée au conteneur. Consultez journalctl -k pour trouver la ligne Memory cgroup out of memory correspondante. Elle confirme le processus choisi par le kernel et indique s’il s’agissait de la limite du conteneur, et non d’un Out of memory déclenché au niveau de l’hôte.