Porque é que os proprietários dos ficheiros dos contentores mudam depois de copiar os dados da aplicação?

Eva Wong é a redatora técnica e entusiasta residente na ZimaSpace. Uma geek desde sempre, apaixonada por homelabs e software de código aberto, dedica-se a traduzir conceitos técnicos complexos em guias práticos. A Eva acredita que a auto-hospedagem deve ser divertida, não intimidante. Através dos seus tutoriais, ajuda a comunidade a desmistificar configurações de hardware, desde montar o primeiro NAS até dominar os contentores Docker.

Os proprietários dos ficheiros do contentor mudam após uma cópia quando os valores numéricos de UID/GID não são preservados ou quando o ambiente de execução de destino os remapeia ou reescreve.

Num NAS doméstico, o mesmo ficheiro pode apresentar um nome de utilizador no anfitrião e outro dentro de um contentor, porque a propriedade é armazenada como números, enquanto cada ambiente resolve esses números através de uma base de dados de contas diferente. As cópias feitas através de uma interface gráfica, uma partilha SMB, um arquivo, uma shell root, uma ferramenta de migração ou um ponto de entrada do contentor também podem substituir a propriedade. Comece por diagnosticar a identidade numérica e, antes de alterar as permissões em toda a árvore de dados da aplicação, distinga o comportamento da cópia, as definições do utilizador em execução, os scripts de arranque, os espaços de nomes de utilizadores e o mapeamento do sistema de ficheiros de rede.

Compare o UID e o GID numéricos antes de comparar os nomes de utilizador

Inspecione a origem e o destino com a propriedade numérica, não apenas com os nomes. Registe o UID, o GID, o modo, as ACL, os atributos estendidos e o sistema de ficheiros de um ficheiro representativo e do respetivo diretório principal, tanto no anfitrião como dentro do contentor.

As montagens bind do Docker expõem ficheiros do anfitrião a processos que podem usar uma base de dados de utilizadores diferente. Uma discussão da comunidade Docker sobre permissões explica por que motivo o acesso fiável depende do alinhamento numérico de UID/GID, e não apenas da correspondência entre nomes de utilizador.

Se os números forem idênticos, mas os nomes apresentados forem diferentes, a propriedade pode não ter mudado. Corrija a documentação ou o mapeamento de contas, em vez de reescrever os dados recursivamente. Se os números forem diferentes, guarde as provas e prossiga para as etapas da cópia e da execução.

Determine se a cópia preservou ou recriou a propriedade

Registe o caminho exato da cópia: gestor de ficheiros do anfitrião, cp, rsync, arquivo tar, cliente SMB/NFS, restauro de cópia de segurança, comando de cópia do Docker ou contentor de migração temporário. Cada método tem predefinições diferentes para proprietário, grupo, ACL e atributos estendidos.

Uma cópia executada como root pode preservar a propriedade numérica quando são usadas opções de arquivo explícitas, enquanto outra ferramenta pode criar todos os ficheiros de destino com a conta que realiza a cópia. Um problema recente de migração de contentores mostra como os dados de uma aplicação copiados podem tornar-se ilegíveis quando o UID de destino é diferente da identidade de execução da aplicação.

Repita a operação com um pequeno diretório de teste e inspecione a propriedade imediatamente antes de a aplicação arrancar. Se os números já estiverem errados, corrija o método de cópia ou reponha as opções. Se só mudarem após o arranque, não altere a cópia e investigue o ponto de entrada do contentor.

Faça corresponder o utilizador do motor de contentores ao proprietário do armazenamento no anfitrião

Inspecione o utilizador efetivo dentro do contentor em execução e o proprietário numérico do diretório de dados da aplicação montado por ligação. Verifique também user: no Compose, os grupos suplementares, as variáveis PUID/PGID da plataforma e quaisquer definições de conta específicas da imagem.

A execução como utilizador não root num contentor não concede automaticamente acesso a um diretório do anfitrião pertencente a outra identidade numérica. Num caso do fórum do Docker, a incompatibilidade é resolvida ao fazer corresponder o utilizador do contentor e as permissões do anfitrião, em vez de tornar o diretório gravável por todos.

Escolha um modelo de propriedade estável para a aplicação e documente-o no Compose. Adicione apenas os grupos necessários para o acesso partilhado. Evite chmod 777, porque oculta a incompatibilidade de identidades, enfraquece o isolamento e não preserva o proprietário pretendido para os ficheiros futuros.

Verifique se o ponto de entrada altera a propriedade durante o arranque

Muitas imagens iniciam brevemente como root, criam os diretórios em falta, aplicam um UID/GID configurado e alteram recursivamente a propriedade antes de abandonar os privilégios. Esse comportamento pode dar a impressão de que uma cópia correta se altera por si só após o primeiro arranque do contentor.

Os motores e as imagens de contentores também podem oferecer um comportamento de montagem que altera a propriedade. Um problema no Podman refere que a opção :U pode reescrever a propriedade da origem, enquanto os scripts de ponto de entrada podem efetuar uma alteração recursiva semelhante durante o arranque da aplicação.

Inicie o contentor uma vez com os registos visíveis e monitorize uma pequena subárvore de teste. Procure no ponto de entrada e nas notas de lançamento da imagem referências a chown, migração de utilizadores, PUID/PGID e passos de correção de permissões. Desative ou limite esse comportamento apenas quando a imagem suportar uma alternativa estável.

Tenha em conta o Docker sem privilégios de root, os espaços de nomes de utilizadores e os sistemas de ficheiros de rede

O Docker sem privilégios de root e o remapeamento de espaços de nomes de utilizadores traduzem os IDs do contentor para outro intervalo no anfitrião. As opções de montagem NFS, CIFS e de alguns NAS também podem, de forma independente, aplicar root-squash ou forçar todos os ficheiros a usar um UID e um GID configurados.

Um relatório de permissões do Docker sem privilégios de root indica que os ficheiros aparecem com uma propriedade inesperada, porque a identidade do contentor é mapeada através de um intervalo subordinado do anfitrião. A pista de diagnóstico é o mapeamento de propriedade do espaço de nomes de utilizadores, não uma falha de cópia convencional.

Verifique se o caminho dos dados é local, NFS, CIFS, FUSE ou outro sistema de ficheiros montado e, em seguida, registe o respetivo comportamento em relação a UID/GID, root-squash e ACL. Teste separadamente a criação de propriedade no anfitrião e no contentor. Não execute chown recursivamente num compartilhamento de rede antes de compreender a política de identidade do lado do servidor.

Reparar a propriedade com base numa identidade conhecida da aplicação

Pare a aplicação, faça uma cópia de segurança dos metadados atuais e defina os UID, GID, modos de diretório, modos de ficheiro, ACL e etiquetas de segurança exatos esperados pela imagem. Corrija apenas os caminhos pertencentes à aplicação, excluindo multimédia partilhada ou conjuntos de dados não relacionados.

O guia ZimaSpace sobre como distinguir falhas de permissões de montagens só de leitura é o próximo passo quando a propriedade correta ainda não permite escrever.

Reinicie o contentor e crie, modifique e elimine um ficheiro de teste com o utilizador real do serviço. Em seguida, recrie o contentor e repita o teste. A reparação só está concluída quando a propriedade se mantém estável após a cópia, o arranque, o reinício e a recriação do contentor, e a aplicação consegue ler e escrever sem exceções de permissões abrangentes.

Assistência e dicas

Mais para ler

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.