#Gerenciar aplicativos

Se você salvou um aplicativo NocoBase como um ambiente CLI, o gerenciamento diário é basicamente concluído no grupo de comandos nb app: iniciar, parar, reiniciar, visualizar logs e atualizar.

Na maioria das vezes, você não precisa se lembrar de todos os parâmetros. Primeiro deixe claro se o que você deseja fazer é “executar o aplicativo”, “ler os logs para solucionar problemas” ou “atualizar para uma nova versão” e, em seguida, selecionar o comando correspondente.

Se você quiser primeiro entender por que nb app é unificado neste conjunto de comandos e sua relação com nb app autostart, primeiro leia nb app design intent. Esta página contém apenas as operações diárias mais comuns.

Índice rápido

Eu quero...Qual comando usar
Iniciar ou retomar a operação do aplicativonb app start
Pare temporariamente o aplicativonb app stop
Pare com o banco de dados integrado gerenciado por CLInb app stop --with-db
Reinicie a aplicação após modificar a configuraçãonb app restart
Visualize logs de aplicativos em tempo realnb app logs
Atualizar para uma nova fonte ou versão de imagemnb app upgrade
primeiro confirme o ambiente atual

O comando nb app atua no ambiente atual por padrão. Se você mantiver vários ambientes ao mesmo tempo, é recomendado, por padrão, confirmar o ambiente de destino antes de iniciar, parar, registrar em log ou atualizar operações.

Se você passar explicitamente um --env diferente, a CLI geralmente solicitará confirmação. Em scripts ou cenários não interativos, você pode adicionar --yes para pular esta etapa. A comutação, visualização e remoção de vários ambientes são introduzidas em Gerenciamento de vários ambientes.

Iniciar aplicativo

Abra o aplicativo e use nb app start por padrão:

nb app start

Se quiser operar em algo diferente do ambiente atual, você pode especificá-lo explicitamente:

nb app start --env app1 --yes

Vários outros parâmetros de inicialização comumente usados:

  • nb app start Por padrão, a instalação necessária ou os preparativos de atualização serão concluídos automaticamente primeiro e, em seguida, o serviço será iniciado.

O ambiente npm/Git local iniciará o processo de aplicativo local e o ambiente Docker reconstruirá o contêiner do aplicativo de acordo com a configuração salva. Para parâmetros detalhados, consulte nb app start.

Pare e reinicie

Se você quiser apenas interromper o aplicativo temporariamente, use nb app stop:

nb app stop

Se você acabou de alterar a configuração, as dependências ou o código, geralmente é mais fácil usar nb app restart diretamente:

nb app restart
nb app restart --env app1 --yes

nb app restart será interrompido primeiro e depois reiniciado da mesma forma que start. Para uso detalhado, consulte nb app stop e nb app restart.

Ver registro

Ao solucionar problemas, você geralmente olha primeiro os logs:

nb app logs

Se você quiser apenas ver a saída mais recente ou não quiser continuar acompanhando o log, você pode usar isto:

nb app logs --tail 200
nb app logs --no-follow
nb app logs --env app1 --yes

O ambiente npm/Git local lê logs pm2 e o ambiente Docker lê logs de contêiner. Por padrão, nb app logs continuará a seguir a nova saída de log. Para parâmetros detalhados, consulte nb app logs.

Atualizar aplicativo

O comando de atualização é nb app upgrade:

nb app upgrade

Este comando faz mais do que apenas “baixar a nova versão”. O processo padrão geralmente inclui:

  1. Pare o aplicativo atual
  2. Baixe e substitua o código-fonte ou imagem salva
  3. Sincronize plug-ins comerciais
  4. Atualize e inicie o aplicativo
  5. Atualize as informações de tempo de execução do ambiente

Se você atualizou o código-fonte ou a imagem antecipadamente e deseja apenas continuar a atualização e iniciar o aplicativo com base no conteúdo atual, você pode adicionar --skip-download:

nb app upgrade --skip-download

Se quiser especificar explicitamente a versão de destino, você também pode adicionar --version:

nb app upgrade --version beta

:::nota de aviso

nb app upgrade Normalmente, você também será solicitado a confirmar uma vez antes de começar. Em scripts, CI ou outros cenários não interativos, --force precisa ser transmitido explicitamente. Se você também opera em ambientes ao mesmo tempo, geralmente precisará reunir --yes.

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

:::

Para obter uma descrição mais completa dos parâmetros, consulte nb app upgrade.