nb plugin import

Importa um arquivo de plugin empacotado ou um pacote npm para storage/plugins. Esse comando apenas coloca o plugin no diretório de destino. Ele não ativa o plugin automaticamente.

Uso

nb plugin import <archive> [flags]

Parâmetros

ParâmetroTipoDescrição
<archive>stringOrigem do plugin. Obrigatório. Aceita um caminho local .tgz, uma URL remota de arquivo http(s) ou um nome / tag de pacote npm
--env, -estringNome do env da CLI. Quando omitido, normalmente usa o env atual. Se você passar --storage-path explicitamente, pode omitir --env
--yes, -ybooleanPula a confirmação interativa quando um --env passado explicitamente aponta para um env diferente do atual
--storage-pathstringSobrescreve o caminho raiz do storage de destino. O diretório real de importação é <storage-path>/plugins
--npm-registrystringEspecifica qual registry npm usar quando a origem for um nome ou tag de pacote npm

Exemplos

# Arquivo remoto
nb plugin import https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz

# Arquivo local
nb plugin import /your/path/plugin-auth-cas-1.4.0.tgz

# Pacote npm ou tag
nb plugin import @my-scope/plugin-auth-cas@beta

# Registry npm privado
nb plugin import @my-scope/plugin-auth-cas@beta --npm-registry=https://registry.example.com

# Gravar diretamente em um caminho local de storage sem depender do env atual
nb plugin import ./plugin-auth-cas-1.4.0.tgz --storage-path ./storage

Notas

Se você já selecionou o env de destino, normalmente basta importar direto para o storage/plugins desse env.

Se você só quer gravar o plugin em um diretório de storage local, passe --storage-path. Nesse caso, você pode omitir --env, e a CLI grava diretamente em <storage-path>/plugins.

Depois do import, o próximo passo normal é reiniciar a aplicação e então decidir se o plugin também precisa ser ativado. Na maioria dos casos:

  • Em uma instalação pela primeira vez, execute nb app restart primeiro e depois nb plugin enable
  • Se você apenas reimportou uma versão mais nova, reinicie a aplicação primeiro e depois verifique se a nova versão já foi carregada

Se a origem estiver em um registry npm privado, faça login primeiro e depois importe:

npm login --registry=https://registry.example.com
nb plugin import @my-scope/plugin-auth-cas@beta --npm-registry=https://registry.example.com
Observação

Você não precisa descompactar nada manualmente em storage/plugins. nb plugin import coloca o plugin automaticamente no diretório correto.

Comandos relacionados