Porque é que um contentor só começa a criar ficheiros pertencentes ao root depois de uma atualização da imagem?

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.

Um contentor pode criar ficheiros pertencentes a root após uma atualização da imagem, se a nova imagem alterar o utilizador de execução, o ponto de entrada ou a rotina de propriedade no arranque.

O volume persistente pode permanecer inalterado, enquanto o contentor de substituição arranca com um UID numérico diferente ou executa brevemente uma etapa de inicialização como root. Um novo ponto de entrada pode criar diretórios em falta, migrar a configuração, reescrever as permissões ou deixar de respeitar as variáveis PUID e PGID usadas pela versão anterior. Antes de aplicar alterações recursivas à propriedade, compare um ficheiro anterior à atualização, um ficheiro criado no arranque e um ficheiro criado pela aplicação em execução.

Comprove que a propriedade só muda depois de o contentor atualizado arrancar

Pare a stack e registe o UID, o GID, o modo, as ACL e as marcas temporais numéricas de um ficheiro existente e do respetivo diretório principal. Inicie o contentor atualizado uma vez com os registos visíveis e, em seguida, inspecione o mesmo caminho e um ficheiro recém-criado.

As chamadas de sistema chown do Linux alteram a propriedade numérica, por isso, a prova decisiva são o UID e o GID antes e depois do arranque, não o nome de utilizador apresentado pelo anfitrião.

Se a propriedade já for de root antes do arranque, a atualização não é a causa inicial. Investigue a cópia da atualização, a extração, o restauro da cópia de segurança ou o comando do administrador que escreveu os ficheiros.

Compare o utilizador da imagem antes e depois da atualização

Inspecione a configuração da imagem antiga e da nova, o utilizador efetivo do contentor, o ponto de entrada, o comando e as notas de lançamento. Registe se a imagem declara agora root, uma conta com nome ou um UID numérico diferente.

A documentação do Docker indica que a instrução USER define a identidade de execução para as instruções seguintes da imagem e para o ponto de entrada e o comando do contentor, quando não são substituídos em tempo de execução.

Uma imagem pode manter o mesmo nome de utilizador da aplicação e, ainda assim, alterar o UID numérico. Compare os números nas duas versões da imagem, porque os ficheiros montados a partir do anfitrião guardam a propriedade numérica, não o nome de utilizador apresentado pela imagem.

Verifique se o novo entrypoint executa um chown recursivo

Procure nos registos de arranque, nas notas de lançamento, nos scripts entrypoint e nos registos de processos referências a chown, reparação de permissões, PUID, PGID, migração de utilizadores ou inicialização de diretórios. Teste numa cópia de segurança pequena ou num volume descartável.

O GNU Coreutils define o chown recursivo como uma reescrita da propriedade em toda a árvore de diretórios selecionada, o que pode fazer com que um volume existente e correto pareça mudar imediatamente após o arranque da nova imagem.

Não remova cegamente a reparação no arranque. Algumas imagens dependem dela para os diretórios recém-criados. Prefira uma opção documentada para a desativar, um UID fixo para a aplicação ou um caminho de dados mais restrito, quando a imagem o permitir.

Audite as substituições de utilizador do Compose e as variáveis PUID ou PGID removidas

Compare o modelo Compose implementado antes e depois da atualização, incluindo user:, variáveis de ambiente, grupos suplementares, perfis, ficheiros de substituição e as definições guardadas pelo gestor da stack.

O Kubernetes utiliza identidades numéricas explícitas para a execução e os volumes, ilustrando o mesmo limite do contentor: uma substituição em tempo de execução e uma política de propriedade dos volumes são definições distintas que têm de permanecer alinhadas.

Se a imagem anterior traduzia as variáveis PUID e PGID, mas a nova versão as removeu ou mudou de nome, as variáveis podem continuar presentes sem controlarem o processo. Verifique diretamente o UID em execução.

Tenha em conta o mapeamento de IDs rootless e de espaços de nomes de utilizadores

Registe se o Docker é executado em modo rootful, rootless ou com remapeamento de espaços de nomes de utilizadores. Compare o UID visível no contentor com o proprietário visível no anfitrião do mesmo inode.

A Red Hat explica que os contentores rootless utilizam intervalos de UID e GID subordinados, pelo que o root do contentor não corresponde necessariamente ao UID 0 do anfitrião e uma atualização pode revelar um mapeamento ou modo de execução alterado.

Não faça chown recursivo de um volume rootless para o root do anfitrião sem compreender o mapeamento. Isso pode tornar os dados inacessíveis à identidade de contentor pretendida.

Verifique se uma montagem com mapeamento de IDs ou uma montagem de rede altera o proprietário visível

Identifique se os dados da aplicação estão num sistema de ficheiros local, numa montagem com mapeamento de IDs, em NFS, SMB, FUSE ou numa partilha NAS. Registe as opções de montagem e compare a propriedade no servidor, no anfitrião e no contentor.

O modelo de montagem com mapeamento de IDs do kernel Linux separa a propriedade do sistema de ficheiros da propriedade da montagem, pelo que o mesmo ficheiro pode surgir com IDs diferentes sem uma alteração física recursiva da propriedade.

Se, após a atualização, apenas o proprietário apresentado mudar, verifique se o espaço de nomes ou o mapeamento de montagem usado em tempo de execução mudou. Corrija o mapeamento em vez de reescrever todos os inodes.

Restabeleça uma identidade de execução estável e verifique a próxima atualização

Crie uma cópia de segurança dos metadados de propriedade, pare a aplicação, defina o UID e o GID numéricos pretendidos, corrija apenas os caminhos pertencentes à aplicação e volte a implementar com uma imagem fixada e definições de utilizador documentadas.

O artigo da ZimaSpace sobre a propriedade dos contentores após copiar dados de aplicações aborda as causas relacionadas com cópias e migrações; este artigo isola uma alteração introduzida pela imagem de substituição.

A reparação está concluída quando o arranque, as escritas da aplicação, a recriação do contentor, o reinício do anfitrião e uma atualização controlada da imagem criam ficheiros com a identidade documentada, sem exceções abrangentes às permissões.

Perguntas frequentes

Um ficheiro pertencente a root prova que todo o contentor é executado como root?

Não. Um ponto de entrada pode executar brevemente como root para inicializar um volume e, depois, abandonar os privilégios antes de a aplicação arrancar.

Devo executar chown recursivamente em todo o volume?

Não sem primeiro identificar o UID pretendido, os caminhos partilhados, as ACL e o mapeamento do espaço de nomes. Uma alteração abrangente pode danificar bases de dados, suportes partilhados ou a propriedade em contentores sem privilégios de root.

Uma atualização da imagem pode alterar o UID da aplicação?

Sim. Os responsáveis pela manutenção podem alterar o utilizador da imagem, reconstruir a base de dados de contas, mudar o nome das definições PUID ou PGID ou adicionar uma migração de propriedade no arranque.

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.