Uma aplicação num contentor pode voltar a usar UTC após uma atualização, se a nova imagem remover os dados de fuso horário, ignorar TZ ou deixar de usar o mount do fuso horário do anfitrião.
O relógio do anfitrião pode continuar correto enquanto a aplicação apresenta as datas em UTC, porque os contentores partilham normalmente o relógio do kernel do anfitrião, mas têm os seus próprios ficheiros de fuso horário, ambiente e dados de execução da linguagem. Uma atualização da imagem pode mudar a distribuição base, remover tzdata, alterar o utilizador da aplicação, substituir o ponto de entrada ou deixar de respeitar uma variável TZ específica do fornecedor. Compare as imagens antiga e nova antes de alterar o fuso horário do anfitrião.
Distinguir a hora do relógio do sistema da formatação do fuso horário
Registe a hora UTC, a hora local apresentada, o nome do fuso horário, o desvio numérico e a hora apresentada pela própria aplicação dentro dos contentores antigo e novo.
A GNU C Library explica que a variável TZ controla a conversão da hora local, enquanto o relógio do sistema subjacente continua a ser uma fonte de tempo absoluto.
Se a hora de época corresponder, mas o fuso horário apresentado mudar, o problema está na configuração do fuso horário e não num desvio do relógio ou no NTP.
Verificar se a nova imagem ainda contém tzdata
Compare os pacotes instalados, /usr/share/zoneinfo, /etc/localtime e /etc/timezone entre as etiquetas da imagem anterior e da atual.
O pacote tzdata do Debian fornece definições de fusos horários usadas pelas aplicações para converter UTC na hora local de cada região.
Uma imagem de substituição mínima pode omitir este pacote deliberadamente. Instale-o numa imagem derivada ou use o mecanismo de fuso horário suportado pela aplicação, em vez de modificar manualmente um contentor em execução.
Verificar como a distribuição base aplica TZ
Identifique se a imagem é Debian, Ubuntu, Alpine, distroless ou se tem outra base. Não parta do princípio de que definir TZ tem efeitos idênticos em todas as imagens.
A documentação do Alpine Linux descreve a configuração do fuso horário através de tzdata e zoneinfo.
Se a atualização tiver alterado a imagem base, repita a configuração do fuso horário usando o método suportado por essa distribuição. Copiar apenas um ficheiro do contentor antigo pode deixar desatualizadas as regras da hora de verão.
Inspecionar o bind mount de localtime do anfitrião
Compare os mounts do contentor em execução antes e depois de o recriar. Verifique se /etc/localtime ou um ficheiro zoneinfo continua montado como só de leitura.
Os bind mounts do Docker mapeiam um ficheiro ou diretório específico do anfitrião para dentro do contentor. As orientações oficiais sobre bind mounts explicam por que razão a remoção de um mount do Compose ou a alteração do caminho de origem faz com que o novo contentor recorra à configuração predefinida da imagem.
Não monte todo o diretório /etc do anfitrião. Use o ficheiro restrito suportado ou a configuração explícita de fuso horário exigida pela aplicação.
Verifique a base de dados de fusos horários do próprio ambiente de execução da aplicação
Determine se a aplicação usa a base de dados zoneinfo do sistema operativo ou inclui dados de fuso horário no Python, Java, PHP, Node.js ou noutro ambiente de execução.
O módulo zoneinfo do Python procura dados do sistema ou um pacote tzdata.
Por conseguinte, uma aplicação pode apresentar UTC mesmo quando os comandos da shell mostram o fuso horário correto. Compare separadamente o comportamento da aplicação em execução com o da shell do contentor.
Verifique a precedência do ambiente do Compose após a recriação
Inspecione o ambiente final do contentor recriado e compare-o com a interpolação do Compose, environment, env_file e os valores predefinidos da imagem.
A documentação de contentores da Red Hat refere que a configuração do ambiente de execução pode substituir o ambiente da imagem, pelo que uma imagem atualizada e um ficheiro de implementação antigo podem produzir um valor final diferente do esperado.
Consulte o ambiente efetivo do contentor, não apenas o ficheiro Compose. Uma interface de pilha desatualizada ou um ficheiro de ambiente alternativo pode ter recriado o serviço sem a variável de fuso horário pretendida.
Fixe a configuração e teste após outra atualização
Escolha um método de fuso horário suportado, fixe-o na configuração de implementação com controlo de versões, recrie o contentor e verifique as datas de inverno e de mudança para a hora de verão, quando aplicável.
O artigo da ZimaSpace sobre a hora das tarefas do contentor e o ambiente fornece o limite de diagnóstico complementar para tarefas agendadas que mudam quando as definições de hora do contentor são alteradas.
O problema fica resolvido quando a aplicação, a shell, os registos e as tarefas agendadas usam o fuso horário pretendido após o reinício e uma nova recriação controlada da imagem.
Perguntas frequentes
Os contentores têm relógio de hardware próprio?
Não. Normalmente, partilham o relógio do kernel do anfitrião, mas podem formatar essa hora com dados de fuso horário e definições de ambiente diferentes.
Definir TZ é sempre suficiente?
Não. A imagem e a aplicação têm de suportar a variável e ter acesso às regras de fuso horário. Alguns ambientes de execução usam uma base de dados incluída em separado.
Devo alterar o fuso horário do anfitrião NAS para corrigir um contentor?
Não. Corrija primeiro a configuração do contentor ou da aplicação; alterar o anfitrião pode afetar os registos, as tarefas agendadas e todos os outros serviços.
Assistência e dicas
Mais para ler

Como manter vídeos para adultos no seu NAS ocultos dos membros da família
Mantenha os vídeos para adultos privados num NAS familiar. Verifique as permissões das pastas, o acesso às bibliotecas do Plex e do Jellyfin, as...

O que verificar antes de carregar um modelo da comunidade em Transformers
Utilize a atualização da sandbox Jinja do Transformers para rever a proveniência dos modelos, os modelos de chat, o código remoto, os pesos serializados...

Execute o Mirage localmente: OCR e deteção de objetos a partir de uma imagem
Experimente o pequeno modelo de visão local da Cactus Compute, valide o OCR e a extração de objetos com dados reais e compreenda os...



