Le concept le plus important concernant le stockage Docker sur ZimaOS est qu’un chemin à l’intérieur d’un conteneur d’application n’est pas le même que celui utilisé par l’hôte pour stocker les données réelles. Plex peut voir /config et /media, tandis que ZimaOS associe ces emplacements à de véritables dossiers sur un disque de stockage.
Le tutoriel de 2024 reste conceptuellement correct. La documentation actuelle d’IceWhale a étendu ce modèle : les utilisateurs peuvent désormais définir l’emplacement global des données des applications sous Settings > Apps, déplacer les données des applications vers un autre espace de stockage, examiner les associations de volumes de chaque application et conserver les données AppData volumineuses à l’écart du petit disque système.
Un conteneur possède son propre système de fichiers
Docker isole chaque application de l’hôte ZimaOS. Dans le conteneur, une application voit son propre système de fichiers, qui commence à /Les fichiers écrits uniquement dans cette couche temporaire peuvent disparaître lorsque le conteneur est recréé.
Les données persistantes nécessitent donc un volume explicite ou un montage bind vers un véritable dossier de l’hôte.
Le chemin sur l’hôte et le chemin dans le conteneur ont des fonctions différentes
Une association telle que :
/DATA/AppData/plex/config → /config
/DATA/Media → /mediasignifie :
- le côté gauche correspond à l’emplacement réel sur l’hôte ZimaOS ;
- le côté droit correspond à ce que Plex voit dans le conteneur.
Plex doit être configuré pour utiliser le chemin dans le conteneur, tandis que les sauvegardes et la gestion des fichiers au niveau de l’hôte doivent cibler le chemin sur l’hôte.
/config de Plex contient l’état persistant de l’application
Le tutoriel d’origine associait /config vers un dossier AppData afin que la base de données de la bibliothèque, les préférences, les métadonnées et les données associées soient conservées après le redémarrage ou la recréation du conteneur.
ZimaOS utilise toujours le même principe de données persistantes, mais le chemin réel sur l’hôte peut changer si l’utilisateur modifie l’emplacement des données des applications.
/media de Plex doit pointer vers la véritable bibliothèque multimédia
Plex ne voit pas automatiquement tous les disques de ZimaOS. Un dossier multimédia de l’hôte doit être monté dans le conteneur Plex, puis sélectionné à partir du chemin correspondant dans le conteneur.
Les paramètres des applications affichent et permettent de modifier les mappages de volumes
Le tutoriel de Zima-Giorgio indiquait aux utilisateurs d’ouvrir les paramètres de Plex et d’inspecter les chemins des volumes. La version actuelle de ZimaOS conserve ce modèle et offre également une visibilité accrue sur le stockage des applications via Paramètres > Applications.
Utilisez le modèle actuel des chemins de stockage des applications de ZimaOS pour comprendre le comportement actuel des chemins.
La version actuelle de ZimaOS permet de déplacer l’emplacement global des données des applications
IceWhale recommande désormais de définir l’emplacement des données des applications sur un véritable espace de stockage plutôt que de remplir le disque système. ZimaOS peut déplacer les données gérées des applications lorsque cet emplacement est modifié.
Cela signifie qu’un chemin codé en dur datant de 2024, tel que /DATA/AppData/plex/config n’est peut-être pas le chemin littéral utilisé sur tous les systèmes actuels.
Sauvegardez les dossiers persistants côté hôte
Lors de la sauvegarde de Plex, protégez le dossier de l’hôte qui stocke /config ainsi que tout autre montage persistant important. Sauvegarder l’image de conteneur jetable est généralement moins utile, car l’image peut être téléchargée à nouveau.
Pour les bases de données, vérifiez si l’application doit être arrêtée ou exportée de manière cohérente avant d’effectuer une sauvegarde au niveau du système de fichiers.
Les médias et AppData sont deux catégories de stockage différentes
La configuration de Plex peut ne représenter que quelques gigaoctets, tandis qu’une bibliothèque multimédia peut atteindre plusieurs dizaines de téraoctets. Elles peuvent résider sur des espaces de stockage différents et avoir des politiques de sauvegarde distinctes.
Ne déplacez pas toute la bibliothèque multimédia simplement parce que vous changez l’emplacement d’AppData de Plex.
Un mappage correct peut tout de même échouer en raison des autorisations
Si Plex peut voir le chemin monté, mais ne peut pas ouvrir les fichiers, l’étape suivante consiste à vérifier le propriétaire et les autorisations du système de fichiers. Si le chemin n’existe pas du tout dans le conteneur, corrigez d’abord le mappage des volumes.
FAQ sur les chemins Docker
Plex doit-il utiliser le chemin de l’hôte ZimaOS dans ses paramètres de bibliothèque ?
Non. Plex doit normalement utiliser le chemin côté conteneur, par exemple /media.
La suppression d’un conteneur Docker supprime-t-elle automatiquement les données AppData associées ?
Non. Les dossiers persistants de l’hôte restent présents, sauf s’ils sont supprimés délibérément.
/DATA/AppData est-il toujours l’emplacement physique actuel d’AppData ?
Pas nécessairement. La version actuelle de ZimaOS permet aux utilisateurs de choisir et de migrer l’emplacement des données gérées des applications.
