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

Plugin tích hợp sẵn

Các plugin tích hợp sẵn của NocoBase sẽ được cập nhật tự động cùng với phiên bản lõi, không cần thao tác thủ công.

Plugin thương mại

Để biết chi tiết về cách kích hoạt và nâng cấp, vui lòng tham khảo: Kích hoạt và nâng cấp 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 đặt plugin này và cần nâng cấp, hãy chạy:

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 cục bộ trước, sau đó tải lên và giải nén thủ công vào thư mục ./storage/plugins. Nếu plugin này đã được bật, hãy chạy lệnh sau sau khi tải lên và giải nén xong để hoàn tất việc nâng cấp plugin.

⚠️ Lưu ý: Để tránh sự cố bộ nhớ đệm, hãy đảm bảo ứng dụng NocoBase đã dừng chạy trước khi thực hiện.

yarn nocobase upgrade --skip-code-update

Cách giải nén plugin đúng cách

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

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 được chỉ định và không tạo thêm một cấp thư mục package dư thừa.

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

Ví dụ về 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