Porque é que o restauro de um volume Docker recria o conteúdo dos ficheiros, mas elimina os atributos estendidos?

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 restauro de volume do Docker pode recriar todos os bytes dos ficheiros e, ainda assim, eliminar os atributos estendidos se o formato do arquivo, as opções, os privilégios ou o destino não permitirem preservá-los.

Os atributos estendidos são pares de nome e valor dos metadados, armazenados separadamente do conteúdo normal dos ficheiros, da propriedade, dos bits de modo e dos carimbos de data/hora. Podem conter dados de ACL, etiquetas SELinux, capacidades do Linux, marcadores de aplicações ou metadados do Samba. Uma cópia de segurança de volume baseada em tar pode restaurar um diretório que parece completo, enquanto as aplicações se comportam de forma diferente porque o arquivo não registou os xattrs ou porque o processo de restauro não conseguiu escrever num namespace protegido.

Faça o inventário dos atributos da origem antes de repetir o restauro

Selecione ficheiros representativos e registe os respetivos hashes, proprietário, modo, ACL e o nome e valor de cada atributo estendido. Inclua ficheiros que deixem de funcionar na aplicação após o restauro.

O modelo xattr do Linux separa os namespaces user, system, security e trusted, cada um com diferentes requisitos de acesso e privilégios.

Se a origem não tiver xattrs, o restauro não os perdeu. Se apenas um namespace desaparecer, concentre-se nos privilégios, na política de segurança ou no suporte do destino, e não na camada de conteúdo dos ficheiros do arquivo.

Verifique o que o comando de cópia de segurança do Docker arquivou realmente

Registe a imagem exata, o comando, o diretório de trabalho, o formato do arquivo, o utilizador, a origem montada e o destino de cópia de segurança montado utilizados pelo contentor de cópia de segurança.

O exemplo de cópia de segurança de volumes do Docker utiliza tar num contentor auxiliar, mas a preservação dos metadados continua a depender da implementação do tar e das opções selecionadas.

Um ficheiro de arquivo criado com sucesso prova que as entradas de diretório e os dados foram lidos, não que todos os namespaces de xattrs foram incluídos. Inspecione o arquivo com a mesma ferramenta utilizada para o criar.

Ativar atributos estendidos durante a criação e a extração do arquivo

Compare as opções do tar utilizadas na cópia de segurança e no restauro. Confirme se os xattrs foram ativados em ambos os sentidos e se os padrões de inclusão ou exclusão não removeram os namespaces necessários.

O GNU tar indica que --xattrs armazena e restaura atributos estendidos.

Adicionar a opção apenas durante a extração não recupera atributos que nunca foram armazenados. Crie um novo arquivo pequeno a partir de um ficheiro de origem com um xattr de teste conhecido e inspecione-o antes de alterar as cópias de segurança de produção.

Utilize as opções corretas de metadados do Rsync para cópias de segurança baseadas em ficheiros

Se a cópia de segurança do volume utilizar Rsync, inspecione as opções de arquivo, ACL, xattr, ID numéricos, fake-super e privilégios, tanto no emissor como no recetor.

O manual oficial do Rsync documenta -X para a preservação de atributos estendidos e descreve o armazenamento fake-super para situações em que os metadados privilegiados não podem ser aplicados diretamente.

A opção de arquivo comum -a não inclui automaticamente todos os requisitos de ACL e xattr. Teste o comando exato nos sistemas de ficheiros de origem e destino reais.

Verifique o suporte do sistema de ficheiros de destino e da montagem

Crie um ficheiro descartável diretamente no volume restaurado e tente definir, listar e remover um xattr de utilizador. Repita o processo através do anfitrião e do contentor de cópia de segurança.

Utilize um utilitário de listagem de atributos tanto no anfitrião como no contentor de restauro para comprovar se o destino aceita e devolve xattrs, independentemente do arquivo de cópia de segurança.

Se a criação direta de xattrs falhar, inspecione o tipo de sistema de ficheiros, as opções de montagem, o protocolo de rede, o controlador de volume e o suporte do dispositivo de armazenamento. Nenhuma opção de arquivo pode restaurar metadados que o destino não consegue representar.

Verifique os privilégios de segurança e os espaços de nomes de confiança

Registe o utilizador do contentor de restauro, as capacidades, o espaço de nomes de utilizador, o modo sem privilégios, a política SELinux e se o caminho do volume está associado ao anfitrião através de uma montagem bind.

A Red Hat documenta que as etiquetas SELinux podem ter de ser restauradas de acordo com a política depois de os ficheiros serem copiados ou recriados.

Não conceda permanentemente privilégios amplos do anfitrião a um contentor de cópia de segurança. Utilize um ambiente de restauro controlado ou restaure primeiro os dados comuns e volte a aplicar as etiquetas geridas por políticas com ferramentas suportadas.

Separe as ACL, as capacidades e os atributos estendidos específicos das aplicações

Compare separadamente as entradas de ACL POSIX, as capacidades de ficheiros Linux, as etiquetas SELinux, os atributos estendidos do utilizador e os metadados do Samba ou macOS. Podem falhar por motivos diferentes.

O módulo xattr_tdb do Samba pode armazenar atributos estendidos separadamente do sistema de ficheiros subjacente.

Um arquivo de volume ao nível dos ficheiros pode, por isso, preservar a árvore de ficheiros visível, mas não uma base de dados separada de metadados do Samba. Inclua todos os repositórios de metadados dependentes ou reconstrua-os através do processo suportado pela aplicação.

Restaure um ficheiro de teste e valide a aplicação

Crie um ficheiro de origem conhecido com um hash do conteúdo, uma ACL, um atributo estendido do utilizador e quaisquer metadados necessários da aplicação. Faça uma cópia de segurança e restaure-o num volume descartável.

O artigo da ZimaSpace sobre alterações de permissões e metadados de NAS aborda um comportamento de migração mais abrangente; este artigo centra-se na cópia de segurança e no restauro de volumes Docker.

O problema fica resolvido quando os hashes do conteúdo, os nomes e valores necessários dos atributos estendidos, as ACL, as etiquetas de segurança e o comportamento da aplicação coincidem após uma segunda cópia de segurança e restauro controlados.

Perguntas frequentes

Os atributos estendidos são o mesmo que as ACL?

Não. Em alguns sistemas de ficheiros, as ACL podem ser implementadas através de atributos estendidos do sistema, mas os atributos estendidos também armazenam etiquetas de segurança, capacidades, metadados do utilizador e valores específicos de aplicações.

O tar preserva atributos estendidos por predefinição?

Não parta desse princípio. O GNU tar disponibiliza opções explícitas para atributos estendidos, e o arquivo tem de armazenar os atributos durante a criação para que possam ser restaurados durante a extração.

Um restauro pode perder atributos estendidos mesmo quando é executado como root?

Sim. O arquivo pode não os conter, o destino pode não os suportar, uma política de segurança pode rejeitá-los ou os metadados podem estar numa base de dados separada da aplicação.

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.