Como adequar as políticas de reinício do Docker a bases de dados, processos de trabalho e aplicações Web

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.

Adapte as políticas de reinício do Docker ao ciclo de vida e à semântica de saída do serviço, em vez de atribuir unless-stopped a todos os contentores de um ficheiro Compose.

As políticas de reinício reagem quando o processo principal de um contentor termina; uma verificação de estado pode assinalar como não saudável um processo que continua em execução, sem o reiniciar automaticamente. Por isso, bases de dados, trabalhadores, aplicações Web, migrações e tarefas agendadas precisam de escolhas diferentes, consoante devam permanecer ativas, o que significa uma saída normal e a forma como as falhas repetidas devem ser comunicadas.

Separe o comportamento de reinício do estado de funcionamento e da prontidão

Uma política de reinício determina se o Docker deve iniciar novamente um contentor após a paragem do respetivo processo. Uma verificação de estado determina se o serviço em execução consegue realizar uma operação definida. A prontidão das dependências determina se outro serviço já deve arrancar. São problemas relacionados, mas distintos.

Um artigo de 2026 sobre como o estado de funcionamento e o reinício são distintos explica esta separação e mostra como as condições de estado do Compose podem atrasar o arranque de serviços dependentes até que um serviço esteja efetivamente pronto.

Não espere que restart: always repare um processo Web em mau estado que nunca termina, nem que uma verificação de estado, por si só, o reinicie. Faça com que a aplicação termine quando não for seguro continuar, adicione um mecanismo de recuperação externo ou emita um alerta sobre o estado de funcionamento, de acordo com a conceção do serviço.

Use políticas de reinício persistentes para bases de dados de longa duração

Normalmente, espera-se que uma base de dados num servidor doméstico volte a funcionar após o reinício do anfitrião ou do daemon do Docker. unless-stopped é muitas vezes uma predefinição prática quando se pretende respeitar uma paragem intencional por parte de um administrador; always é adequado quando, por definição, o reinício deve sobrepor-se a esse estado de paragem manual.

Um artigo de julho de 2026 sobre como uma política de reinício depende da saída do processo explica as diferenças entre no, on-failure, always e unless-stopped, incluindo o facto de a política reagir à saída do processo e não ao estado de funcionamento.

A base de dados também precisa de uma verificação de estado real e de armazenamento persistente. Reiniciar o PostgreSQL repetidamente não resolve um disco cheio, uma configuração inválida, um estado corrompido ou uma migração incompatível. Emita alertas para reinícios repetidos, em vez de os tratar como uma resiliência bem-sucedida.

Escolha a política do trabalhador de acordo com a fila e a semântica de saída

Um trabalhador de filas de longa duração pode justificar unless-stopped se deve estar sempre a processar tarefas. Um trabalhador finito ou um processo em lote pode usar on-failure:N para permitir um número limitado de novas tentativas em caso de erros transitórios, enquanto uma falha persistente faz com que o processo pare de forma visível.

Uma regra atual de tentativas limitadas após falhas salienta que o comportamento das novas tentativas deve corresponder ao facto de um processo dever permanecer ativo indefinidamente ou poder terminar normalmente.

Saiba o que significa o código de saída 0 para a imagem do processo de trabalho. Se significar «trabalho concluído», always pode transformar um trabalho único concluído num ciclo interminável. Se o processo de trabalho tiver de funcionar como daemon, uma saída normal inesperada pode justificar um novo arranque automático através de unless-stopped.

Mantenha as aplicações web em execução prolongada, mas condicione o arranque a dependências reais

A maioria das aplicações web autoalojadas destina-se a permanecer continuamente disponível, pelo que unless-stopped costuma ser mais fácil de gerir do que uma política limitada apenas às falhas. A definição de reinício não elimina a necessidade de a base de dados, a cache, o DNS, os segredos e os caminhos montados estarem prontos.

O diagnóstico relacionado da ZimaSpace sobre ciclos de reinícios causados por dependências de contentores explica por que razão reiniciar repetidamente a aplicação visível pode ocultar a falha inicial na base de dados, na cache, na montagem, na migração ou na memória.

Use verificações de estado das dependências para ordenar o arranque, quando apropriado, e limite o comportamento de novas tentativas da aplicação. Um serviço web que falha a cada cinco segundos até o PostgreSQL arrancar é menos fácil de monitorizar do que um que aguarda pela prontidão e inicia corretamente à primeira.

Dê às migrações e aos trabalhos de execução única um ciclo de vida finito

Os contentores de migração, os importadores, as tarefas de manutenção e os trabalhos de inicialização única não são daemons comuns. O seu estado de sucesso é muitas vezes «saída 0 e permanecer parado». Usar always ou unless-stopped pode voltar a executar trabalho já concluído sem intenção.

Mantenha as ferramentas operacionais de execução única explícitas, em vez de permitir que se tornem serviços ocultos sempre ativos. Uma migração ou importador deve ter um estado de sucesso finito, que permaneça visível após a saída do comando.

Use restart: "no" quando a falha deve levar à paragem para inspeção, ou uma política on-failure limitada apenas quando for seguro repetir o comando. No caso das migrações de esquema, confirme que é possível repetir uma migração parcialmente aplicada antes de automatizar novas tentativas.

Teste a política com modos de falha reais

Para cada serviço, teste uma saída normal do processo, uma falha com código diferente de zero, o reinício do anfitrião, o reinício do daemon do Docker, uma paragem manual, uma condição de execução sem estado saudável e uma dependência indisponível. Registe o estado esperado após cada evento antes de considerar a configuração resiliente.

Acompanhe o número de reinícios e emita um alerta quando ultrapassar um limite baixo dentro de um intervalo de tempo. O reinício automático deve reduzir o tempo de recuperação de falhas transitórias; não deve tornar invisível uma falha persistente através de um fluxo interminável de novos contentores.

Uma boa matriz de políticas é explícita: as bases de dados e aplicações web de longa duração voltam a arrancar após reinícios da infraestrutura, os processos de trabalho em segundo plano recuperam de acordo com a semântica das filas, as tarefas finitas param quando terminam e as verificações de estado e prontidão revelam falhas que a política de reinício não deteta.

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.