A publicação de 2023 sobre a “migração de aplicações legadas” descreve uma transição do CasaOS 0.4.4, não um fluxo universal de migração atual. A IceWhale instruiu os utilizadores da versão 0.4.4 a reconstruírem manualmente as aplicações legadas e os utilizadores de versões anteriores a atualizarem primeiro para a 0.4.4-1.
Como o empacotamento das aplicações do CasaOS/ZimaOS mudou substancialmente desde então, o comando de atualização histórico não deve ser copiado para um sistema moderno apenas para migrar uma aplicação.
O que fazia a antiga funcionalidade de migração
A interface separava as definições de aplicações mais antigas do novo modelo baseado em Compose e disponibilizava ações como Reconstruir e Exportar como Compose. O objetivo era manter as definições da aplicação ao mesmo tempo que se convertia a definição da aplicação.
O antigo comando de atualização 0.4.4-1 é histórico
A publicação original incluía um procedimento de atualização pontual curl ... | sudo bash para utilizadores do CasaOS 0.4.3 e anteriores. Tratava-se de uma transição específica entre versões de 2023, não de um comando seguro e intemporal.
Uma resposta de 2024 já evidenciava o problema: um utilizador com uma versão posterior do CasaOS deixou de ver os mesmos botões.
As lojas de aplicações modernas utilizam contratos de metadados mais recentes
O atual guia de migração da App Store v1 para v2 documenta um protocolo de loja mais recente, com store.json, index.json, store-config.json e IDs de aplicações obrigatórios.
Essa página destina-se aos responsáveis pela manutenção das lojas de aplicações, mas demonstra por que motivo a antiga interface de “aplicações legadas” deve ser considerada uma camada histórica de migração.
Para migrar uma aplicação, proteja primeiro os respetivos dados
Antes de substituir uma definição de aplicação antiga, registe a imagem, as portas, as variáveis de ambiente e os caminhos dos volumes no anfitrião. Faça uma cópia de segurança dos dados e da configuração persistentes e, em seguida, recrie a aplicação utilizando o pacote atual da loja ou um ficheiro Compose revisto.
O guia Noções básicas da migração de aplicações Docker aborda os componentes do contentor que precisam efetivamente de ser preservados.
Em resumo
O antigo botão Reconstruir era uma ferramenta de compatibilidade da era do CasaOS 0.4.4. Não faça downgrade nem execute um script de atualização histórico para recuperar exatamente esse menu. Preserve os dados da aplicação, exporte ou reconstrua as definições do Compose e, em seguida, faça a migração para o modelo de aplicações atual.
