Solução da comunidade

Compreenda os caminhos das aplicações Docker no ZimaOS: configuração do Plex, multimédia, caminhos do anfitrião e volumes de contentores

A July 2024 official Zima-Giorgio tutorial explaining Docker container paths and host-side ZimaOS volume mappings through Plex. The core model remains current, while ZimaOS now also supports choosing a global App data location and moving managed application data to another storage space.

O conceito mais importante sobre o armazenamento Docker no ZimaOS é que um caminho dentro de um contentor de aplicações não é o mesmo caminho que o anfitrião utiliza para armazenar os dados reais. O Plex pode ver /config e /media, enquanto o ZimaOS mapeia essas localizações para pastas reais numa unidade de armazenamento.

O tutorial de 2024 continua conceptualmente correto. A documentação atual da IceWhale expandiu o modelo: os utilizadores podem agora definir a localização global dos dados das aplicações em Definições > Aplicações, mover os dados das aplicações para outro espaço de armazenamento, inspecionar os mapeamentos de volumes por aplicação e manter grandes quantidades de AppData afastadas da pequena unidade do sistema.

Diagrama que mostra um caminho AppData do anfitrião ZimaOS mapeado para um caminho mais curto dentro de um contentor Docker
A pasta do anfitrião e a pasta do contentor podem ter nomes diferentes, embora se refiram aos mesmos dados montados.

Um Contentor Tem o Seu Próprio Sistema de Ficheiros

O Docker isola cada aplicação do anfitrião ZimaOS. Dentro do contentor, uma aplicação vê o seu próprio sistema de ficheiros raiz, que começa em /Os ficheiros escritos apenas nessa camada descartável podem desaparecer quando o contentor é recriado.

Por isso, os dados persistentes precisam de um volume explícito ou de uma montagem bind para uma pasta real no anfitrião.

O Caminho do Anfitrião e o Caminho do Contentor Têm Funções Diferentes

Um mapeamento como:

/DATA/AppData/plex/config  →  /config
/DATA/Media                →  /media

significa:

  • o lado esquerdo é a localização real no anfitrião ZimaOS;
  • o lado direito é o que o Plex vê dentro do contentor.

O Plex deve ser configurado para utilizar o caminho no contentor, enquanto as cópias de segurança e a gestão de ficheiros ao nível do anfitrião devem ter como destino o caminho no anfitrião.

Plex /config Contém o Estado Persistente da Aplicação

O tutorial de origem mapeou o /config para uma pasta AppData, para que a base de dados da biblioteca, as preferências, os metadados e o estado relacionado sobrevivam a reinícios ou à recriação do contentor.

O ZimaOS atual continua a utilizar o mesmo princípio de dados persistentes, mas o caminho real do anfitrião pode mudar se o utilizador alterar a localização dos dados das aplicações.

Plex /media Deve Apontar para a Biblioteca Multimédia Real

O Plex não deteta automaticamente todos os discos no ZimaOS. É necessário montar uma pasta multimédia do anfitrião no contentor Plex e, em seguida, selecioná-la a partir do caminho correspondente no contentor.

Exemplo da aplicação Plex utilizado no tutorial do caminho Docker do ZimaOS
O Plex é um exemplo útil, porque a sua configuração e os seus dados multimédia têm necessidades de persistência claramente diferentes.

As definições das aplicações mostram e permitem editar os mapeamentos dos volumes

O tutorial do Zima-Giorgio indicava aos utilizadores que abrissem as definições do Plex e verificassem os caminhos dos volumes. O ZimaOS atual mantém este modelo e também disponibiliza uma visão mais abrangente do armazenamento das aplicações através de Definições > Aplicações.

Utilize o modelo atual de caminhos de armazenamento de aplicações do ZimaOS para compreender o comportamento atual dos caminhos.

O ZimaOS atual permite mover a localização global dos dados das aplicações

A IceWhale recomenda agora apontar a localização dos dados das aplicações para um espaço de armazenamento real, em vez de encher a unidade do sistema. O ZimaOS pode mover os dados das aplicações geridas quando essa localização é alterada.

Isto significa que um caminho fixo de 2024, como /DATA/AppData/plex/config pode não ser o caminho literal em todos os sistemas atuais.

Faça uma cópia de segurança das pastas persistentes no lado do anfitrião

Ao fazer uma cópia de segurança do Plex, proteja a pasta do anfitrião que armazena /config e quaisquer outras montagens persistentes importantes. Fazer uma cópia de segurança da imagem descartável do contentor é normalmente menos valioso, porque a imagem pode ser obtida novamente.

No caso das bases de dados, considere se a aplicação precisa de ser parada ou exportada de forma consistente antes de efetuar uma cópia de segurança ao nível do sistema de ficheiros.

Os conteúdos multimédia e os dados das aplicações são classes de armazenamento diferentes

A configuração do Plex pode ocupar apenas alguns gigabytes, enquanto uma biblioteca multimédia pode ocupar dezenas de terabytes. Podem estar em espaços de armazenamento diferentes e ter políticas de cópia de segurança distintas.

Não mova toda a biblioteca multimédia só porque alterou a localização dos dados da aplicação do Plex.

Um mapeamento correto pode ainda falhar devido a permissões

Se o Plex consegue ver o caminho montado, mas não consegue abrir os ficheiros, a camada seguinte a verificar é a propriedade e as permissões do sistema de ficheiros. Se o caminho não existir dentro do contentor, corrija primeiro o mapeamento do volume.

Perguntas frequentes sobre caminhos do Docker

O Plex deve utilizar o caminho do anfitrião ZimaOS nas definições da biblioteca?

Não. Normalmente, o Plex deve utilizar o caminho no lado do contentor, como /media.

A eliminação de um contentor Docker elimina automaticamente os dados das aplicações mapeados?

Não. As pastas persistentes no anfitrião permanecem, a menos que sejam removidas deliberadamente.

/DATA/AppData é sempre a localização física atual dos dados das aplicações?

Não necessariamente. O ZimaOS atual permite aos utilizadores escolher e migrar a localização dos dados das aplicações geridas.