O “Script de Instantâneo Premium do ZimaOS” não é um instantâneo do ZimaOS no sentido de um instantâneo do sistema de ficheiros/máquina virtual. Não cria um instantâneo Btrfs nem uma imagem de cópia de segurança. É um script Bash da comunidade que recolhe um relatório de diagnóstico: versão do sistema, utilização de recursos, temperaturas, sistemas de ficheiros, estado do RAID, estado de saúde SMART, contentores Docker, tamanho do AppData, configuração de rede e processos principais.
Isso torna-o potencialmente útil para o suporte, mas também significa que o texto gerado pode conter detalhes do ambiente que talvez não queira publicar. Zima-Giorgio elogiou a ideia e sugeriu guardar os ficheiros de relatório iterativos em /DATA porque essa localização é mais fácil de aceder a partir de Ficheiros. A IceWhale não adotou nem certificou o script como ferramenta de diagnóstico integrada nesta discussão.
O script cria um único relatório do sistema legível por humanos
O script de origem recolhe:
- versão do ZimaOS, variante, data de compilação, nome do anfitrião, fabricante, modelo;
- carga do CPU, memória, swap e temperaturas;
- utilização do sistema de ficheiros e disposição dos discos;
- estado de RAID e Btrfs;
- estado de saúde SMART dos discos;
- contentores Docker em execução e terminados;
- tamanhos dos diretórios AppData e Main-Storage;
- interfaces IPv4, bridges e rota predefinida;
- processos que mais utilizam CPU e memória.
Um relatório de diagnóstico não é uma cópia de segurança nem um instantâneo do sistema de ficheiros
A palavra “instantâneo” pode induzir em erro. O script escreve informações do sistema num ficheiro de texto; não captura bases de dados de aplicações, ficheiros, camadas de contentores nem o estado do armazenamento num determinado momento para efeitos de restauro.
Para fins de recuperação, utilize a cópia de segurança do ZimaOS, exportações compatíveis com as aplicações, proteção RAID ou ferramentas reais de instantâneos do sistema de ficheiros/máquinas virtuais.
O script original escrevia em Main-Storage
O script V1 criava:
/media/Main-Storage/Zima_snapshot/e guardava aí relatórios de texto datados. Esse caminho pressupõe que o espaço de armazenamento do utilizador se chama efetivamente Main-Storage.
Noutro sistema, codificar esse caminho diretamente pode falhar ou escrever num local não pretendido se o ponto de montagem não estiver disponível.
Zima-Giorgio sugeriu /DATA para facilitar o acesso
Na resposta final da fonte, Zima-Giorgio disse que, se o projeto continuasse a ser desenvolvido, sugeriria guardar os ficheiros de saída em /DATA porque esse diretório é mais fácil de aceder através da aplicação Ficheiros.
Este foi um comentário oficial sobre o projeto da comunidade, não um anúncio de que a IceWhale tivesse integrado o script.
A saída SMART precisa de interpretação por dispositivo
O relatório de exemplo mostrava campos SMART tradicionais de discos HDD, como temperatura, setores realocados, setores pendentes, erros CRC e horas de funcionamento. Também mostrava “SMART não disponível” para os dispositivos NVMe, porque a análise simples do script não produzia uma saída NVMe equivalente.
Não interprete “não disponível” neste script como prova de que o NVMe não tem telemetria de estado de saúde.
O script foi criado com base na configuração RAID 5 do autor
O exemplo identifica explicitamente md0 e apresenta uma secção “Estado do RAID5”. Outra instalação do ZimaOS pode utilizar RAID 1, RAID 6, JBOD, ZFS, discos individuais ou dispositivos md com nomes diferentes.
Antes de reutilizar o script, reveja todos os dispositivos codificados, caminhos de montagem e pressupostos relativos ao sistema de ficheiros.
Os dados do Docker podem expor o inventário de aplicações
O relatório inclui nomes de imagens de contentores e nomes de aplicações. Isso é útil para a equipa de suporte, mas uma publicação pública pode revelar quais os serviços que executa, que versões estão instaladas e, potencialmente, quais as aplicações que estão desatualizadas.
Redija os nomes de serviços desnecessários quando o relatório for publicado fora de um canal de suporte de confiança.
Os dados de rede podem revelar a topologia interna
O relatório de exemplo apresenta nomes de interfaces, endereços IP da LAN, redes virtuais, bridges Docker e rotas predefinidas. O autor da fonte ocultou manualmente parte das informações de IP no exemplo publicado.
Antes de partilhar publicamente um relatório, reveja:
- endereços IP e sub-redes;
- nomes de anfitriões;
- nomes de interfaces VPN/overlay;
- nomes de montagens e partilhas;
- nomes de aplicações/contentores;
- quaisquer caminhos que incluam identificadores pessoais.
Prefira diagnósticos só de leitura
A vantagem deste tipo de script é que a maioria dos dados úteis para a resolução de problemas pode ser recolhida através de comandos só de leitura, como informações do sistema, utilização do disco, consultas SMART, listagens do Docker e inspeção de processos.
Um script de diagnóstico não deve reiniciar serviços silenciosamente, limpar o Docker, modificar metadados RAID nem eliminar registos. Mantenha a recolha de evidências separada das ações de reparação.
O ZimaOS atual já disponibiliza mais diagnósticos de armazenamento e aplicações
As Definições > Aplicações atuais mostram a utilização do armazenamento e os controlos da cache por aplicação, enquanto o Armazenamento apresenta o estado dos discos e as informações sobre os arrays. Comece por utilizar a visibilidade integrada e, em seguida, adicione um relatório da comunidade quando o suporte precisar de um instantâneo mais abrangente do sistema num único ficheiro.
As ferramentas atuais de visibilidade do armazenamento das aplicações podem responder a muitas questões relacionadas com o espaço sem um script personalizado.
Perguntas frequentes sobre o instantâneo de diagnóstico
Este script cria um instantâneo recuperável do sistema?
Não. Cria um relatório de diagnóstico em texto.
A IceWhale adotou oficialmente o script?
Não. O Zima-Giorgio elogiou-o e sugeriu armazenar os relatórios em /DATA, mas o código continua a ser criado pela comunidade.
O relatório deve ser publicado publicamente sem revisão?
Não. Pode expor endereços IP, topologia, nomes de armazenamento, inventário de aplicações e outros detalhes do ambiente.
