Skip to content

Ghim Phiên bản Node

Một trong những tính năng mạnh mẽ nhất của Volta là khả năng ghim các phiên bản công cụ cụ thể vào dự án của bạn, đảm bảo rằng mọi người làm việc trên dự án sử dụng chính xác cùng một chuỗi công cụ.

Tại sao cần Ghim Phiên bản?

  • Tính nhất quán: Mọi người trong nhóm của bạn sử dụng cùng các phiên bản
  • Khả năng tái lập: Môi trường xây dựng khớp với môi trường phát triển
  • Độ tin cậy: Không có bất ngờ từ hành vi công cụ không mong muốn
  • Nhóm mới: Thành viên nhóm mới tự động có thiết lập đúng

Cách ghim Node.js

Để ghim một phiên bản Node.js cụ thể vào dự án của bạn:

bash
volta pin node@16.14.2

Lệnh này:

  1. Tải và cài đặt Node.js 16.14.2 (nếu chưa có)
  2. Cập nhật package.json của bạn với một phần volta
  3. Làm cho dự án sử dụng Node.js 16.14.2 bất cứ khi nào bạn chạy node trong thư mục dự án

package.json của bạn bây giờ sẽ chứa:

json
{
  "volta": {
    "node": "16.14.2"
  }
}

Ghim Trình quản lý Gói

Bạn cũng có thể ghim các phiên bản cụ thể của trình quản lý gói:

bash
volta pin npm@8.5.0
volta pin yarn@1.22.18
volta pin pnpm@7.0.0

Điều này đảm bảo mọi người sử dụng cùng phiên bản trình quản lý gói, ngăn ngừa các inconsistency lockfile và các vấn đề phiên bản khác.

Sau khi ghim npm, package.json của bạn sẽ trông như thế này:

json
{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  }
}

Sử dụng Công cụ đã Ghim

Sau khi các công cụ được ghim, không cần lệnh bổ sung. Chỉ cần điều hướng đến thư mục dự án của bạn và chạy các lệnh như bình thường:

bash
# Những lệnh này sẽ sử dụng các phiên bản đã ghim của dự án
node --version
npm --version

Volta tự động phát hiện khi bạn ở trong một thư mục có các phiên bản đã ghim và sử dụng chúng thay vì các công cụ mặc định của bạn.

Cập nhật Phiên bản đã Ghim

Để cập nhật một phiên bản đã ghim:

bash
volta pin node@latest
volta pin npm@latest

Hoặc chỉ định một phiên bản mới:

bash
volta pin node@18

Thông lệ Tốt nhất

Khi nào nên Ghim

  • Cho ứng dụng sản xuất: Luôn ghim cả Node và trình quản lý gói của bạn
  • Cho thư viện/gói: Ghim Node nếu mã của bạn dựa trên các tính năng Node cụ thể
  • Cho công cụ/tiện ích: Ghim phiên bản Node tối thiểu cần thiết cho chức năng

Lựa chọn Phiên bản

  • Cho các ứng dụng, chọn một phiên bản LTS (Hỗ trợ Dài hạn) của Node
  • Cho các thư viện, sử dụng phiên bản Node cũ nhất mà bạn muốn hỗ trợ
  • Cập nhật các phiên bản định kỳ để được hưởng các bản sửa lỗi bảo mật

Tích hợp CI/CD

Đảm bảo các pipeline CI/CD của bạn tôn trọng các phiên bản đã ghim của bạn:

  • Sử dụng Volta GitHub Action trong các workflow GitHub
  • Cho các hệ thống CI khác, cài đặt Volta và nó sẽ tự động sử dụng các phiên bản đã ghim của bạn

Released under the BSD 2-Clause License.