Instalar y actualizar plugins

Plugins integrados

Los plugins integrados de NocoBase se actualizan automáticamente junto con la versión del núcleo, sin necesidad de operaciones manuales.

Plugins comerciales

Para ver los métodos detallados de activación y actualización, consulta: Activación y actualización de plugins comerciales

Plugins de terceros

Instalar plugins mediante la línea de comandos

yarn pm pull https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz
yarn pm pull /your/path/plugin-auth-cas-1.4.0.tgz

Si la aplicación ya tiene instalado este plugin y necesitas actualizarlo, ejecuta:

yarn nocobase upgrade --skip-code-update

Cargar y extraer manualmente

Primero descarga el paquete del plugin en local y luego súbelo y extráelo manualmente en el directorio ./storage/plugins. Si el plugin ya está habilitado, ejecuta el siguiente comando después de completar la carga y la extracción para finalizar la actualización del plugin.

⚠️ Nota: Para evitar problemas de caché, asegúrate de que la aplicación NocoBase esté detenida antes de ejecutar el comando.

yarn nocobase upgrade --skip-code-update

Forma correcta de extraer un plugin

El siguiente ejemplo muestra cómo extraer correctamente el paquete del plugin en el directorio especificado:

mkdir -p /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas && \
  tar -xvzf /downloads/plugin-auth-cas-1.4.0.tgz \
  -C /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas \
  --strip-components=1

Este comando extrae el plugin en el directorio especificado y no genera una capa adicional de directorio package.

/my-nocobase/storage/plugins/@nocobase/plugin-auth-cas

Ejemplo de estructura de directorios correcta

./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.js
./plugin-auth-cas/dist/server/auth.js
./plugin-auth-cas/client.js
./plugin-auth-cas/dist/constants.js
./plugin-auth-cas/dist/externalVersion.js
./plugin-auth-cas/dist/client/index.js
./plugin-auth-cas/dist/index.js
./plugin-auth-cas/dist/server/index.js
./plugin-auth-cas/dist/server/actions/login.js
./plugin-auth-cas/dist/server/plugin.js
./plugin-auth-cas/server.js
./plugin-auth-cas/dist/server/actions/service.js
./plugin-auth-cas/dist/locale/en-US.json
./plugin-auth-cas/dist/locale/ko_KR.json
./plugin-auth-cas/package.json
./plugin-auth-cas/dist/locale/zh-CN.json
./plugin-auth-cas/README.md
./plugin-auth-cas/README.zh-CN.md
./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.d.ts
./plugin-auth-cas/dist/server/auth.d.ts
./plugin-auth-cas/client.d.ts
./plugin-auth-cas/dist/constants.d.ts
./plugin-auth-cas/dist/client/index.d.ts
./plugin-auth-cas/dist/client/locale/index.d.ts
./plugin-auth-cas/dist/index.d.ts
./plugin-auth-cas/dist/server/index.d.ts
./plugin-auth-cas/dist/server/actions/login.d.ts
./plugin-auth-cas/dist/client/Options.d.ts
./plugin-auth-cas/dist/server/plugin.d.ts
./plugin-auth-cas/server.d.ts
./plugin-auth-cas/dist/server/actions/service.d.ts
./plugin-auth-cas/dist/client/SigninPage.d.ts
./plugin-auth-cas/LICENSE.txt