Como reduzir o tempo de arranque do Immich após reiniciar o sistema

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.

Se o Immich só demorar a ficar utilizável depois de o servidor doméstico reiniciar, meça qual é a dependência que fica pronta por último antes de tentar «acelerar» a própria aplicação.

Um reinício pode fazer com que as montagens de armazenamento, o PostgreSQL, os caminhos de rede, o DNS ou outros serviços fiquem disponíveis numa ordem diferente daquela que se verifica durante um reinício normal do Immich. A métrica útil não é a hora a que o Docker indica que um contentor arrancou; é o tempo decorrido desde o arranque do anfitrião até a base de dados aceitar pedidos reais, o armazenamento necessário estar montado, o Immich deixar de repetir tentativas de ligação às dependências e um cliente conseguir carregar a cronologia. Registe essa sequência uma vez e, em seguida, elimine a espera real ou o ciclo de novas tentativas.

Meça a cronologia do arranque antes de alterar qualquer coisa

Reinicie durante uma janela de manutenção e registe a hora de quatro momentos: anfitrião acessível, armazenamento relacionado com o Immich montado, base de dados saudável e Immich utilizável num cliente. Registe também as horas de início dos contentores, os estados de saúde, o número de reinícios e a primeira linha útil dos registos de cada serviço. Assim, «o arranque parece lento» transforma-se num atraso delimitado.

Compare o resultado com um reinício normal da pilha, efetuado depois de o anfitrião estar totalmente operacional. Se o Immich reiniciar rapidamente mais tarde, mas for lento apenas durante o arranque, o estrangulamento deverá estar relacionado com uma dependência de ordem ou disponibilidade externa à aplicação. Se for igualmente lento em ambos os casos, investigue o trabalho da base de dados, a latência do armazenamento, as migrações ou a pressão sobre o CPU.

Não otimize todas as camadas de uma só vez. O objetivo desta fase é identificar o primeiro componente cuja disponibilidade se atrasa em relação ao início do respetivo contentor ou que obriga repetidamente o Immich a tentar novamente.

Verifique se o armazenamento está pronto antes de o Immich arrancar

Confirme que todos os pontos de montagem vinculados e caminhos de rede existem e contêm os dados esperados antes de os serviços do Immich arrancarem. Um ponto de montagem pode existir como diretório local vazio enquanto o disco real ou a partilha NAS ainda não está disponível, o que pode fazer com que a aplicação arranque com uma vista do sistema de ficheiros incorreta.

Se a base de dados ou os ficheiros multimédia estiverem num armazenamento que só fica disponível mais tarde durante o arranque, configure o serviço para depender dessa montagem ao nível do anfitrião ou adie a pilha até ser possível verificar que a montagem está presente. O teste deve verificar o sistema de ficheiros realmente montado ou um marcador conhecido, não apenas a existência do nome do diretório.

Depois de ajustar a disponibilidade do armazenamento, reinicie novamente e compare os mesmos carimbos temporais. Uma alteração bem-sucedida elimina as tentativas repetidas ou o comportamento de caminhos vazios sem alterar a configuração estável do Immich. Se o armazenamento já estava pronto bem antes da base de dados, passe para a sequência de dependências em vez de adicionar temporizadores de espera arbitrários.

Aguarde até a base de dados estar saudável, não apenas em execução

O PostgreSQL pode ter um contentor em execução antes de estar pronto para aceitar a carga de trabalho da aplicação, sobretudo após uma paragem inesperada, atrasos no armazenamento, inicialização ou recuperação. Compare a transição do estado de saúde da base de dados com os primeiros erros de ligação do Immich nos registos de arranque.

Uma ordem de arranque simples pode iniciar um contentor dependente antes de o serviço de que precisa estar realmente pronto. Quando a sua versão do Compose e as definições dos serviços o permitirem, as verificações de dependências baseadas no estado podem distinguir entre «contentor iniciado» e «dependência pronta». Utilize-as para eliminar ciclos de reconexão evitáveis, em vez de ocultar uma dependência lenta ou com problemas.

Mantenha a verificação de prontidão restrita e significativa. Uma verificação da base de dados deve confirmar que esta consegue aceitar a ligação necessária ao Immich; não deve executar uma consulta dispendiosa que provoque atrasos adicionais. Assim que a prontidão da base de dados anteceder consistentemente o arranque do Immich, repita o teste de reinício do anfitrião antes de alterar qualquer outra coisa.

Distinga os ciclos de novas tentativas do trabalho legítimo de arranque

Se o armazenamento e o PostgreSQL estiverem prontos, mas o Immich continuar a demorar muito mais tempo após o reinício, inspecione os registos da aplicação e dos processos de trabalho para detetar falhas de ligação repetidas, verificações de estado falhadas, migrações, inicialização de tarefas ou pressão sobre os recursos. Erros repetidos em intervalos regulares indicam muitas vezes que o sistema está à espera; atividade contínua da CPU ou do disco, com progresso, indica trabalho real de arranque.

A ordem das dependências funciona melhor quando acompanhada por verificações de estado significativas, em vez de breves atrasos fixos. Um padrão de verificação de estado do Compose pode ajudar a evitar que uma aplicação tente ligar-se a uma base de dados ou a uma cache que ainda está a inicializar. Mantenha as verificações realistas; reduzir os intervalos até um serviço com problemas parecer saudável não melhora o arranque.

Se o número de reinícios aumentar durante o arranque, interrompa o ciclo e identifique a primeira dependência indisponível antes de ajustar a CPU, a memória ou os parâmetros de arranque da imagem. Uma verificação de dependências de contentores em ciclo de reinício ajuda a distinguir um pré-requisito lento de um problema no próprio Immich.

Reinicie novamente e confirme quanto tempo demora até ser realmente utilizável

Depois de uma alteração específica, faça um reinício completo do anfitrião e registe os mesmos carimbos temporais. Uma melhoria real deverá reduzir o intervalo entre a prontidão das dependências e a utilização do cliente Immich, sem introduzir novos ciclos de reinício, pontos de montagem em falta ou erros em segundo plano.

Teste mais do que a página de início de sessão da Web. Abra várias fotografias antigas, faça uma pesquisa, carregue um vídeo representativo, confirme que um cliente móvel consegue estabelecer ligação e carregue um ficheiro descartável para testar os percursos de leitura e escrita. Para efeitos domésticos, o servidor não está «arrancado» até estas operações normais funcionarem.

Faça um segundo reinício depois do primeiro teste bem-sucedido para garantir que o resultado não se deveu a um acaso da cache ou a um evento pontual de temporização da rede. Se o arranque continuar inconsistente, preserve os registos de arranque e concentre-se no componente cuja prontidão varia entre execuções. Não mascare a variabilidade com um atraso fixo mais longo, a menos que não tenha um sinal de prontidão melhor.

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.