Restaure o Jellyfin após uma atualização falhada do contentor, protegendo o estado persistente antes de substituir, reverter ou recriar o ambiente de execução.
Uma atualização falhada pode dever-se a um problema com a imagem, a uma variável de ambiente alterada, a um mapeamento de dispositivo perdido, a um erro no volume ou a um problema de migração da aplicação. Registe o estado da falha e identifique qual foi a camada alterada. A recuperação é mais segura quando o diretório de configuração permanece intacto até saber se a falha ocorreu no ambiente de execução ou nos dados.
Congele o estado da falha antes de fazer outra transferência
Desative as atualizações automáticas e os ciclos de reinício para que cada nova tentativa não altere os registos, as etiquetas da imagem ou o estado da aplicação. Guarde a definição efetiva do contentor e o primeiro erro fatal.
É muito mais fácil reverter uma atualização falhada quando já existe uma cópia de segurança do Jellyfin anterior à alteração; sem uma, uma falha do ambiente de execução pode transformar-se num problema de recuperação do estado.
Registe o resumo criptográfico da imagem, as montagens, os dispositivos, o ambiente, o modo de rede e os registos recentes. Não execute comandos de limpeza ou remoção enquanto o conjunto necessário para a recuperação ainda estiver a ser identificado.
Proteja a configuração e a base de dados antes de recriar seja o que for
A imagem substituível deve estar separada da base de dados persistente do Jellyfin, da configuração, dos metadados e dos plugins. Faça uma cópia só de leitura ou um instantâneo antes de abrir novamente esse estado com um binário mais antigo ou mais recente.
As cópias de segurança da configuração do Jellyfin protegem as contas de utilizador, as definições das bibliotecas, o histórico de visualização e os metadados separadamente da própria biblioteca multimédia.
Copie o caminho persistente para uma segunda localização e preserve a propriedade dos ficheiros. O limite de persistência do contentor só está correto se um ambiente de execução limpo conseguir voltar a ligar-se sem produzir um servidor vazio.
Restaure a menor camada afetada
Se a imagem antiga funcionar com o mesmo estado e as mesmas montagens, a falha pertence ao processo de atualização e não à biblioteca. Se ambas as versões falharem, pare de alternar entre imagens e investigue separadamente os dados ou as permissões.
Uma falha de arranque do Jellyfin específica de uma versão deve ser separada de alterações gerais ao armazenamento e à rede.
Teste uma reversão ou uma imagem conhecida como estável com uma cópia do conjunto de dados de estado. Evite forçar migrações repetidas na única cópia da base de dados.
Valide a identidade, as bibliotecas e uma reprodução antes de retomar a automatização
Um contentor que chega ao estado “em execução” não está totalmente restaurado até que os utilizadores esperados, as bibliotecas, o estado de visualização, os caminhos e o comportamento de reprodução regressem. As análises e a automatização associada podem criar novas gravações, por isso mantenha-as pausadas durante a validação.
Um teste de restauro adequado verifica o comportamento da aplicação após a recuperação, em vez de considerar a extração bem-sucedida dos ficheiros como prova suficiente.
Confirme a identidade do servidor, a consulta de uma biblioteca, uma reprodução direta, uma transcodificação, se utilizada, e um reinício. Só depois volte a ativar as análises agendadas e as atualizações automáticas.
Suporte e Dicas
Mais para Ler

Deve fazer uma cópia de segurança do Jellyfin em funcionamento ou parar primeiro o serviço?
Prefira cópias de segurança com o serviço parado, pela sua simplicidade; utilize instantâneos em funcionamento apenas quando o estado da aplicação for capturado de...

Porque é que o Jellyfin funciona a altas temperaturas ou faz ruído quando ninguém está a transmitir?
O calor em inatividade normalmente indica atividade em segundo plano ou uma carga de trabalho de um anfitrião partilhado; por isso, identifique o processo...

Quando deve reconstruir em vez de reparar o Jellyfin?
Escolha recriar em vez de reparar quando o problema for a divergência do ambiente de execução e o estado persistente estiver salvaguardado; não «recrie»...

