Quản lý Dự án của bạn

Volta cho phép các nhóm và cộng tác viên tiêu chuẩn hóa các công cụ phát triển mà họ sử dụng cho các dự án của mình. Hướng dẫn này sẽ cho bạn biết cách quản lý hiệu quả các dự án của mình với Volta.

Ghim Phiên bản Công cụ

Tính năng quản lý dự án quan trọng nhất trong 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:

Ghim Node.js

Để chỉ định phiên bản Node.js nào mà dự án của bạn nên sử dụng:

volta pin node@16.14.2

Bạn cũng có thể ghim vào phiên bản chính hoặc phụ, và Volta sẽ sử dụng phiên bản khớp mới nhất:

volta pin node@16

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

Tương tự, bạn có thể ghim các phiên bản npm và Yarn:

volta pin npm@8.5.0
volta pin yarn@1.22.18

Ghim Hoạt động như thế nào

Khi bạn ghim một phiên bản công cụ, Volta:

1. Cập nhật file package.json của dự án của bạn với một phần volta
2. Commit thông tin này vào kiểm soát phiên bản
3. Đảm bảo mọi người trong nhóm của bạn sử dụng cùng các phiên bản

Đây là phần volta trông như thế nào trong package.json của bạn:

{
  "name": "your-project",
  "version": "1.0.0",
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0",
    "yarn": "1.22.18"
  }
}

Công cụ Cục bộ Dự án

Volta cũng tôn trọng các cài đặt công cụ cục bộ dự án:

Sử dụng Binary Gói Cục bộ

Khi bạn cài đặt các gói cục bộ trong dự án của mình:

npm install typescript
# hoặc
yarn add typescript

Bạn có thể chạy các binary của chúng thông qua Volta:

volta run tsc
# hoặc đơn giản
tsc

Volta sẽ sử dụng phiên bản Node.js được ghim của dự án để chạy các công cụ này.

Hỗ trợ Workspace

Đối với thiết lập monorepo với nhiều dự án, Volta hỗ trợ kế thừa cấu hình:

Mở rộng Cấu hình

Trong một workspace với nhiều dự án, bạn có thể thiết lập một cấu hình cơ bản trong package.json root:

{
  "volta": {
    "node": "16.14.2",
    "yarn": "1.22.18"
  }
}

Sau đó trong các file package.json của dự án riêng lẻ, mở rộng cấu hình root:

{
  "volta": {
    "extends": "../../package.json"
  }
}

Điều này cho phép bạn duy trì các phiên bản công cụ nhất quán trên tất cả các dự án trong workspace của bạn.

Thông lệ Tốt nhất cho Quản lý Dự án

Đây là một số thông lệ được khuyến nghị để quản lý các dự án với Volta:

1. Luôn Ghim Công cụ của bạn

Gim các phiên bản Node.js và trình quản lý gói cho mọi dự án:

volta pin node
volta pin npm
# hoặc
volta pin yarn

Điều này đảm bảo môi trường phát triển nhất quán cho tất cả thành viên nhóm.

2. Commit Cấu hình Volta

Luôn commit phần volta trong package.json của bạn vào kiểm soát phiên bản. Đây là cách Volta chia sẻ cấu hình với nhóm của bạn.

3. Tài liệu hóa Yêu cầu Công cụ

Trong README của dự án của bạn, đề cập rằng bạn sử dụng Volta để quản lý công cụ:

## Phát triển

Dự án này sử dụng [Volta](https://volta.sh) để đảm bảo công cụ nhất quán.
Cài đặt Volta, và các phiên bản đúng của Node.js và npm sẽ được sử dụng tự động.

4. Sử dụng Tích hợp CI/CD

Trong các môi trường tích hợp liên tục, cài đặt Volta như một phần của quy trình xây dựng của bạn:

# Ví dụ cho GitHub Actions
- name: Install Volta
  uses: volta-cli/action@v1

# Volta sẽ tự động sử dụng các phiên bản Node.js và npm/yarn đúng
- name: Install dependencies
  run: npm install

5. Tiêu chuẩn hóa Trên các Dự án

Đối với các tổ chức có nhiều dự án, hãy tiêu chuẩn hóa các phiên bản công cụ khi có thể để giảm thiểu số lượng phiên bản mà nhà phát triển cần cài đặt.

Bằng cách quản lý hiệu quả các dự án của bạn với Volta, bạn đảm bảo rằng tất cả thành viên nhóm có môi trường phát triển nhất quán, giảm các vấn đề "hoạt động trên máy của tôi" và làm cho cộng tác mượt mà hơn.