• Português

      • Atualizar o aplicativo NocoBase

      Escopo

      Este guia se aplica a aplicativos instalados com nb init. Se o seu aplicativo foi instalado pelo método antigo, leia primeiro Como atualizar o NocoBase de 2.0 para 2.1.

      Etapa 1: confirme o env atual

      Primeiro confirme o CLI env ativo:

      nb env current

      Se você não souber quais envs estão disponíveis, liste-os primeiro:

      nb env list

      Se o env atual não for o aplicativo que você quer atualizar, alterne para o env de destino:

      nb env use <env-name>

      Etapa 2: execute a atualização

      Observação

      Por padrão, a atualização baixa novamente o código-fonte do aplicativo ou a imagem Docker.

      Para envs npm / Git, o diretório source/ é excluído e baixado novamente. Não coloque arquivos que precisam ser preservados em source/.

      Se você já preparou manualmente o código-fonte ou a imagem Docker e não quer que a CLI baixe novamente, adicione --skip-download ao comando.

      O comando padrão de atualização é:

      nb app upgrade

      Esse comando normalmente executa estas etapas:

      1. Para o aplicativo atual
      2. Baixa e substitui o código ou a imagem salvos
      3. Sincroniza plugins comerciais
      4. Atualiza e inicia o aplicativo
      5. Atualiza as informações de runtime do env

      Em scripts, CI ou sessões de AI Agent, passe --force explicitamente:

      nb app upgrade --force

      Se o aplicativo a ser atualizado não for o env atual, especifique o env:

      nb app upgrade --env app1 --yes --force

      Atualizar para uma versão específica

      Use --version para atualizar para um canal de versão específico:

      nb app upgrade --version beta

      Você também pode informar uma versão exata:

      nb app upgrade --version 2.1.0-beta.24

      Após uma atualização bem-sucedida, a CLI grava a versão de destino de volta na configuração do env, para que atualizações ou recuperações futuras possam reutilizá-la.

      Pular o download

      Se você já atualizou o código-fonte ou a imagem Docker e quer apenas executar a atualização e iniciar com o conteúdo atual, adicione --skip-download:

      nb app upgrade --skip-download

      Esse parâmetro pula o download do código ou da imagem e também pula a sincronização de plugins comerciais. Normalmente use apenas quando a versão de destino já tiver sido preparada manualmente.

      Etapa 3: verifique o resultado

      Após a atualização, verifique primeiro o runtime do env e os logs do aplicativo:

      nb env info
nb app logs

      Depois abra o aplicativo e confirme que a conta de administrador consegue entrar. Se você quiser que um AI Agent continue trabalhando com esse aplicativo, inicie uma nova sessão do AI Agent ou reinicie a sessão atual para que ele leia as informações mais recentes do env.