Il concetto più importante dello storage Docker su ZimaOS è che un percorso all'interno del container di un'app non coincide con il percorso utilizzato dall'host per archiviare i dati effettivi. Plex potrebbe visualizzare /config e /media, mentre ZimaOS associa queste posizioni a cartelle reali su un'unità di archiviazione.
Il tutorial del 2024 rimane concettualmente corretto. La documentazione attuale di IceWhale ha ampliato il modello: ora gli utenti possono impostare la posizione globale dei dati delle app in Impostazioni > App, spostare i dati delle applicazioni in un altro spazio di archiviazione, esaminare le mappature dei volumi per ogni app e mantenere i dati AppData di grandi dimensioni lontani dalla piccola unità di sistema.
Un container ha il proprio filesystem
Docker isola ogni app dall'host ZimaOS. All'interno del container, un'app vede il proprio filesystem radicato in /I file scritti solo in quel livello temporaneo possono scomparire quando il container viene ricreato.
I dati persistenti richiedono quindi un volume esplicito o un bind mount a una vera cartella dell'host.
Il percorso dell'host e il percorso del container svolgono funzioni diverse
Un'associazione come:
/DATA/AppData/plex/config → /config
/DATA/Media → /mediasignifica:
- il lato sinistro è la posizione reale sull'host ZimaOS;
- il lato destro è ciò che Plex vede all'interno del container.
Plex deve essere configurato per utilizzare il percorso all'interno del container, mentre i backup e la gestione dei file a livello di host devono utilizzare il percorso sul lato host.
/config di Plex contiene lo stato persistente dell'applicazione
Il tutorial originale associava /config in una cartella AppData, affinché il database della libreria, le preferenze, i metadati e lo stato correlato sopravvivano ai riavvii o alla ricreazione del container.
L'attuale ZimaOS continua a utilizzare lo stesso principio dei dati persistenti, ma il percorso effettivo sull'host può cambiare se l'utente modifica la posizione dei dati delle app.
/media di Plex deve puntare alla libreria multimediale reale
Plex non visualizza automaticamente ogni disco in ZimaOS. Una cartella multimediale dell'host deve essere montata nel container Plex e quindi selezionata dal percorso corrispondente all'interno del container.
Le impostazioni delle app mostrano e consentono di modificare le mappature dei volumi
Il tutorial di Zima-Giorgio indicava agli utenti di aprire le impostazioni di Plex e controllare i percorsi dei volumi. L'attuale ZimaOS mantiene questo modello e offre inoltre una visibilità più ampia sull'archiviazione delle app tramite Impostazioni > App.
Utilizzate l'attuale modello dei percorsi di archiviazione delle app di ZimaOS per comprendere il comportamento attuale dei percorsi.
L'attuale ZimaOS consente di spostare la posizione globale dei dati delle app
IceWhale ora consiglia di impostare la posizione dei dati delle app su uno spazio di archiviazione reale invece di riempire l'unità di sistema. ZimaOS può spostare i dati delle app gestite quando questa posizione viene modificata.
Ciò significa che un percorso codificato staticamente come /DATA/AppData/plex/config potrebbe non essere il percorso letterale su tutti i sistemi attuali.
Eseguite il backup delle cartelle persistenti lato host
Quando eseguite il backup di Plex, proteggete la cartella host che contiene /config e qualsiasi altro mount persistente importante. Eseguire il backup dell'immagine del container usa e getta è solitamente meno utile, perché l'immagine può essere scaricata di nuovo.
Per i database, valutate se sia necessario arrestare l'applicazione o esportare i dati in modo coerente prima di eseguire un backup a livello di filesystem.
Media e AppData sono classi di archiviazione diverse
La configurazione di Plex può occupare solo pochi gigabyte, mentre una libreria multimediale può raggiungere decine di terabyte. Possono risiedere su spazi di archiviazione diversi e avere criteri di backup differenti.
Non spostate l'intera libreria multimediale solo perché cambiate la posizione di AppData di Plex.
Una mappatura corretta può comunque non funzionare a causa dei permessi
Se Plex riesce a vedere il percorso montato ma non può aprire i file, il livello successivo da controllare riguarda il proprietario e i permessi del filesystem. Se il percorso non esiste affatto all'interno del container, correggete prima la mappatura del volume.
FAQ sui percorsi Docker
Plex dovrebbe usare il percorso host di ZimaOS nelle impostazioni della libreria?
No. Plex dovrebbe normalmente utilizzare il percorso lato container, ad esempio /media.
L'eliminazione di un container Docker elimina automaticamente i dati AppData mappati?
No. Le cartelle persistenti sull'host rimangono, a meno che non vengano rimosse deliberatamente.
/DATA/AppData è sempre l'attuale posizione fisica di AppData?
Non necessariamente. L'attuale ZimaOS consente agli utenti di scegliere e migrare la posizione dei dati delle app gestite.
