Solução da comunidade

Problemas do ZimaOS 1.7.0: o que foi corrigido no 1.7.1

A ZimaBoard 2 owner reported multiple ZimaOS 1.7.0 regressions involving Tailscale, the App Store, Plex, update detection, AppData deletion and Files performance.

Resposta atual: se ainda estiver no ZimaOS 1.7.0, atualize para a versão 1.7.1 antes de voltar a diagnosticar estes erros

O tópico agrupava muitas falhas, mas várias foram posteriormente identificadas individualmente: a desinstalação de aplicações podia eliminar os AppData, as operações com ficheiros podiam consumir uma quantidade anormal de memória, o arranque do Docker e o comportamento da App Store precisavam de melhorias, e existiam alguns problemas relacionados com USB/RAID/cópias de segurança no mesmo ciclo de versões. O ZimaOS 1.7.1 foi lançado especificamente como uma versão de correção de segurança e estabilidade e resolveu diretamente vários desses problemas.

As alterações do ZimaOS 1.7.1 incluem a correção da eliminação da configuração das aplicações, além de melhorias no Docker e na App Store.

Faça uma cópia de segurança dos AppData antes de desinstalar qualquer coisa no 1.7.0

A falha de conceção mais grave confirmada no caso original foi a remoção da pasta de configuração durante a eliminação de uma aplicação. A IceWhale reproduziu o problema e corrigiu-o posteriormente na versão 1.7.1. Se estiver a recuperar uma instalação antiga do 1.7.0, copie os AppData e as bases de dados críticos antes de desinstalar/reinstalar o Plex ou outro serviço.

A cópia de segurança do ZimaOS é a camada de segurança adequada. Não parta do princípio de que reinstalar um contentor é inofensivo quando os caminhos persistentes não foram verificados.

Utilize o Tailscale da App Store em vez de um sysext nativo antigo, quando possível

O sistema original utilizava uma extensão de sistema nativa do Tailscale mantida pela comunidade e encontrou uma condição de corrida durante o arranque inicial, porque o /DATA ainda não estava pronto quando o serviço arrancou. Isto é específico da conceção do sysext da comunidade e não prova que o Tailscale atual no ZimaOS seja intrinsecamente pouco fiável.

O ZimaOS atual disponibiliza oficialmente o Tailscale na App Store. A configuração do Tailscale no ZimaOS evita a manutenção de um serviço personalizado de arranque inicial. Os requisitos do Tailscale fornecem o contexto necessário do lado da aplicação.

Atualize e teste a cache da nova experiência de aplicações antes de repor o servidor

O sintoma de a “experiência antiga das aplicações voltar após o reinício” desapareceu posteriormente depois de uma atualização do navegador, o que torna plausível uma explicação relacionada com a cache ou o estado do cliente. Faça uma atualização forçada ou utilize uma janela privada do navegador antes de reinstalar serviços apenas porque a apresentação da interface parece antiga.

As atualizações falsas de aplicações exigem evidências da API

Chrome DevTools a mostrar a resposta da API de aplicações atualizáveis do ZimaOS durante a resolução de problemas de atualizações falsas de contentores
A IceWhale pediu ao utilizador que inspecionasse o pedido apps/upgradable, porque o ZimaOS 1.7.0 mostrava repetidamente seis atualizações de contentores que não eram concluídas.

O sistema mostrava repetidamente seis atualizações, depois a lista de atualizações desaparecia, voltava a aparecer e ficava bloqueada em “A carregar atualizações…”. A IceWhale pediu a resposta de rede de apps/upgradable, porque o distintivo da interface, por si só, não podia provar que existiam seis atualizações reais de imagens.

Se utilizar etiquetas Docker flutuantes, como :latest, tenha em atenção que o nome da etiqueta, por si só, não prova que a imagem local esteja atualizada. A fixação de imagens Docker explica por que motivo as etiquetas mutáveis complicam as comparações de atualizações.

Separe a velocidade do disco da velocidade da aplicação Ficheiros

O utilizador mediu aproximadamente 196 MB/s ao escrever diretamente no RAID, enquanto a aplicação Ficheiros demorou cerca de uma hora a copiar 6 GB e consumiu muita CPU. Esta é uma evidência importante: o próprio caminho do disco conseguia atingir uma velocidade de transferência muito superior, pelo que o estrangulamento estava provavelmente na operação do serviço de ficheiros/interface e não no RAID físico.

dd if=/dev/zero of=/media/STORAGE/test.img bs=1M count=2000 status=progress conv=fdatasync

O ZimaOS 1.7.1 corrigiu posteriormente o consumo anormal de memória em determinadas operações com ficheiros, mas não afirme que todos os problemas de desempenho ao copiar através da aplicação Ficheiros foram resolvidos. Volte a testar exatamente a mesma carga de trabalho no 1.7.1.

Reinstale apenas a aplicação que está realmente avariada

O Plex acabou por funcionar após a reinstalação e o restauro dos AppData. O comportamento do mosaico do Pi-hole desapareceu depois de o problema mais amplo da interface das aplicações ter sido resolvido, e a verificação do Uptime Kuma exigiu a recriação de uma bridge. São problemas distintos. Resolver um deles através de uma reinstalação não justifica reinstalar todos os contentores.

Os requisitos das aplicações do ZimaOS ajudam a manter explícitas as dependências de cada aplicação.

Utilize um problema por ramo de diagnóstico

Um registo útil de resolução de problemas do 1.7.x deve separar: arranque do Tailscale, interface da App Store, arranque de contentores individuais, deteção de atualizações, desempenho da aplicação Ficheiros, montagem automática de USB e comportamento dos AppData. Registe os passos de reprodução e as evidências de cada problema. Um único relatório a afirmar que “o 1.7 estragou tudo” é compreensível do ponto de vista emocional, mas difícil de resolver de forma sistemática.

Não faça downgrade antes de conhecer o custo da recuperação

Como o 1.7.1 inclui uma correção de segurança nos serviços de ficheiros, permanecer indefinidamente no 1.7.0 é uma solução temporária pouco recomendável a longo prazo. Faça uma cópia de segurança, atualize para o 1.7.1, volte a testar cada problema e só considere reverter/reinstalar se uma regressão específica continuar a ser reproduzível.

Perguntas frequentes

O ZimaOS 1.7.1 corrigiu a eliminação dos AppData?

Corrigiu um problema em que a desinstalação de uma aplicação podia eliminar a pasta de configuração da aplicação.

Porque é que o ZimaOS mostra atualizações de aplicações que desaparecem?

O distintivo pode refletir metadados de gestão de aplicações ou etiquetas de imagens mutáveis. Capture a resposta da API de aplicações atualizáveis e o estado real da imagem antes de presumir que cada distintivo corresponde a uma atualização real.

Devo continuar a utilizar um sysext do Tailscale?

Utilize o caminho atual do Tailscale através da App Store, a menos que precise especificamente da extensão nativa da comunidade e consiga mantê-la.

Porque é que a aplicação Ficheiros é lenta quando o benchmark do RAID é rápido?

Isso permite isolar o disco físico do serviço de ficheiros de nível superior. Compare a mesma carga de trabalho através da CLI, de SMB e da aplicação Ficheiros para identificar a camada mais lenta.

Devo fazer downgrade a partir do 1.7.0?

A versão atual 1.7.1 contém correções importantes de segurança e estabilidade. Faça uma cópia de segurança e atualize primeiro; em seguida, avalie qualquer regressão reproduzível que permaneça.