การจัดการโปรเจกต์ของคุณ

Volta ช่วยให้ทีมและ colaboradores สามารถมาตรฐานเครื่องมือการพัฒนาที่ใช้สำหรับโปรเจกต์ของพวกเขา คู่มือนี้จะแสดงวิธีจัดการโปรเจกต์ของคุณอย่างมีประสิทธิภาพด้วย Volta

การปักหมุดเวอร์ชันเครื่องมือ

ฟีเจอร์การจัดการโปรเจกต์ที่สำคัญที่สุดใน Volta คือความสามารถในการปักหมุดเวอร์ชันเครื่องมือเฉพาะกับโปรเจกต์ของคุณ:

การปักหมุด Node.js

เพื่อระบุเวอร์ชัน Node.js ที่โปรเจกต์ของคุณควรใช้:

volta pin node@16.14.2

คุณสามารถปักหมุดไปยังเวอร์ชันหลักหรือรองได้ และ Volta จะใช้เวอร์ชันที่ตรงล่าสุด:

volta pin node@16

การปักหมุด Package Managers

ในทำนองเดียวกัน คุณสามารถปักหมุดเวอร์ชัน npm และ Yarn ได้:

volta pin npm@8.5.0
volta pin yarn@1.22.18

วิธีการปักหมุดทำงาน

เมื่อคุณปักหมุดเวอร์ชันเครื่องมือ Volta:

1. อัปเดตไฟล์ package.json ของโปรเจกต์ด้วยส่วน volta
2. Commit ข้อมูลนี้ไปยัง version control
3. ตรวจสอบให้แน่ใจว่าทุกคนในทีมของคุณใช้เวอร์ชันเดียวกัน

นี่คือลักษณะของส่วน volta ใน package.json ของคุณ:

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

เครื่องมือเฉพาะโปรเจกต์

Volta เคารพการติดตั้งเครื่องมือเฉพาะโปรเจกต์ด้วย:

การใช้ไบนารีแพ็กเกจในท้องถิ่น

เมื่อคุณติดตั้งแพ็กเกจในท้องถิ่นในโปรเจกต์ของคุณ:

npm install typescript
# หรือ
yarn add typescript

คุณสามารถเรียกใช้ไบนารีของพวกเขาผ่าน Volta:

volta run tsc
# หรือเพียง
tsc

Volta จะใช้เวอร์ชัน Node.js ที่ปักหมุดของโปรเจกต์เพื่อเรียกใช้เครื่องมือเหล่านี้

การสนับสนุน Workspaces

สำหรับการตั้งค่า monorepo ที่มีหลายโปรเจกต์ Volta สนับสนุนการสืบทอดการกำหนดค่า:

การขยายการกำหนดค่า

ใน workspace ที่มีหลายโปรเจกต์ คุณสามารถตั้งค่าพื้นฐานใน package.json root:

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

จากนั้นในไฟล์ package.json ของโปรเจกต์แต่ละโปรเจกต์ ขยายการกำหนดค่า root:

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

สิ่งนี้ช่วยให้คุณรักษาเวอร์ชันเครื่องมือที่สอดคล้องกันทั่วทั้งโปรเจกต์ทั้งหมดใน workspace ของคุณ

แนวปฏิบัติที่ดีที่สุดสำหรับการจัดการโปรเจกต์

นี่คือแนวปฏิบัติที่แนะนำสำหรับการจัดการโปรเจกต์ด้วย Volta:

1. ปักหมุดเครื่องมือของคุณเสมอ

ปักหมุดเวอร์ชัน Node.js และ package manager สำหรับทุกโปรเจกต์:

volta pin node
volta pin npm
# หรือ
volta pin yarn

สิ่งนี้ตรวจสอบให้แน่ใจว่าสภาพแวดล้อมการพัฒนาสอดคล้องกันสำหรับสมาชิกทีมทุกคน

2. Commit การกำหนดค่า Volta

Commit ส่วน volta ใน package.json ของคุณไปยัง version control เสมอ นี่คือวิธีที่ Volta แชร์การกำหนดค่ากับทีมของคุณ

3. เอกสารข้อกำหนดเครื่องมือ

ใน README ของโปรเจกต์ของคุณ กล่าวถึงว่าคุณใช้ Volta สำหรับการจัดการเครื่องมือ:

## การพัฒนา

โปรเจกต์นี้ใช้ [Volta](https://volta.sh) เพื่อให้แน่ใจว่าเครื่องมือสอดคล้องกัน
ติดตั้ง Volta และเวอร์ชันที่ถูกต้องของ Node.js และ npm จะถูกใช้โดยอัตโนมัติ

4. ใช้การผสานรวม CI/CD

ในสภาพแวดล้อมการบูรณาการอย่างต่อเนื่อง ติดตั้ง Volta เป็นส่วนหนึ่งของกระบวนการ build ของคุณ:

# ตัวอย่างสำหรับ GitHub Actions
- name: Install Volta
  uses: volta-cli/action@v1

# Volta จะใช้เวอร์ชัน Node.js และ npm/yarn ที่ถูกต้องโดยอัตโนมัติ
- name: Install dependencies
  run: npm install

5. มาตรฐานข้ามโปรเจกต์

สำหรับองค์กรที่มีหลายโปรเจกต์ มาตรฐานเวอร์ชันเครื่องมือเมื่อเป็นไปได้เพื่อลดจำนวนเวอร์ชันที่ผู้พัฒนาต้องติดตั้ง

ด้วยการจัดการโปรเจกต์ของคุณอย่างมีประสิทธิภาพด้วย Volta คุณจะตรวจสอบให้แน่ใจว่าสมาชิกทีมทั้งหมดมีสภาพแวดล้อมการพัฒนาที่สอดคล้องกัน ลดปัญหา "ทำงานบนเครื่องของฉัน" และทำให้การทำงานร่วมกันราบรื่นขึ้น