Solução da comunidade

Corrigir com segurança o Compose defeituoso do Paperless-ngx no ZimaOS: Tika

A Coolstore Paperless-ngx install failed around the Tika image; the user later got a BigBear package running after several attempts, but the earlier failure cause remained unverified.

Se uma aplicação Paperless-ngx de terceiros falhar porque o respetivo ficheiro Compose referencia uma imagem Tika inválida, corrija a definição da aplicação ou utilize um pacote mantido, em vez de reinstalar repetidamente o mesmo Compose danificado. No tópico original, o pacote Coolstore apontava para uma imagem Tika que o utilizador considerava incorreta, enquanto um pacote BigBear acabou por ser instalado com sucesso após várias tentativas.

O tópico nunca estabeleceu por que motivo as tentativas anteriores com o BigBear falharam, pelo que seria incorreto afirmar que alterar apenas a secção do IP é uma solução universal. A abordagem duradoura consiste em comparar o Compose de terceiros com os requisitos atuais do Paperless-ngx.

O Tika é um serviço opcional do Paperless

A atual referência de configuração do Paperless-ngx explica que o Tika e o Gotenberg são serviços opcionais utilizados para documentos do Office e análise de emails. Quando essa integração está ativada, o Paperless tem de ser configurado com endpoints acessíveis.

Isto significa que uma imagem de serviço Tika defeituosa pode interromper uma instalação que ativa a integração, mesmo que a definição do contentor principal do Paperless seja válida.

Trate o Coolstore e o BigBear como pacotes de terceiros

Uma resposta da comunidade observou corretamente que o Coolstore é uma fonte de aplicações de terceiros. Uma referência de imagem danificada nesse pacote deve ser comunicada ao respetivo responsável pela manutenção, em vez de ser interpretada como um defeito do núcleo do ZimaOS.

Se um pacote da loja estiver desatualizado, compare-o com os exemplos Docker do Paperless a montante ou com outro pacote mantido. Faça uma cópia de segurança dos caminhos dos dados existentes antes de alterar as stacks.

Edite ou importe novamente o Compose com cuidado

As versões atuais do ZimaOS podem importar definições Docker Compose personalizadas. O guia de resolução de problemas do Compose personalizado é a opção mais segura quando uma definição da loja de aplicações contém uma imagem inválida ou um campo não suportado.

O ZimaOS 1.7.1 também indica uma compatibilidade melhorada ao guardar YAML nas notas de lançamento atuais. Essa melhoria não corrige automaticamente uma referência de imagem incorreta num repositório de terceiros.

Antes de reinstalar novamente o Paperless

  • Faça uma cópia de segurança das localizações dos dados, dos ficheiros multimédia e da base de dados do Paperless.
  • Confirme que todas as referências de imagens existem e são mantidas.
  • Mantenha o Paperless, a respetiva base de dados, o Redis, o Tika e o Gotenberg nas redes Compose previstas.
  • Altere apenas uma origem de falha de cada vez, para que seja possível identificar a correção bem-sucedida.

Se uma instalação for subitamente bem-sucedida após várias tentativas, como aconteceu no tópico, não invente uma causa. Mantenha o resultado identificado como sucesso verificado pelo utilizador, com a falha original por esclarecer.