Cài đặt và nâng cấp Plugin

Plugin tích hợp sẵn

Plugin tích hợp sẵn của NocoBase sẽ được tự động cập nhật theo phiên bản kernel, không cần thao tác thủ công.

Plugin thương mại

Cách cài đặt và nâng cấp chi tiết vui lòng tham khảo: Hướng dẫn kích hoạt Plugin thương mại

Plugin bên thứ ba

Cài đặt Plugin bằng dòng lệnh

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

Nếu ứng dụng đã cài Plugin này và cần nâng cấp, vui lòng thực thi:

yarn nocobase upgrade --skip-code-update

Tải lên và giải nén thủ công

Vui lòng tải gói Plugin về máy trước, sau đó upload và giải nén thủ công vào thư mục ./storage/plugins. Nếu Plugin này đã được kích hoạt, vui lòng thực thi lệnh sau sau khi upload và giải nén để hoàn thành nâng cấp Plugin.

Lưu ý: Để tránh vấn đề cache, vui lòng đảm bảo ứng dụng NocoBase đã dừng chạy trước khi thực thi.

yarn nocobase upgrade --skip-code-update

Cách giải nén Plugin đúng

Ví dụ sau minh họa cách giải nén gói Plugin đúng vào thư mục đích:

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

Lệnh này sẽ giải nén Plugin vào thư mục đích và không tạo ra cấp thư mục package thừa.

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

Ví dụ cấu trúc thư mục đúng

./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