Mengelola Proyek Anda

Volta memungkinkan tim dan kolaborator untuk menstandarkan alat pengembangan yang mereka gunakan untuk proyek mereka. Panduan ini akan menunjukkan cara mengelola proyek Anda secara efektif dengan Volta.

Memin Versi Alat

Fitur manajemen proyek paling penting di Volta adalah kemampuan untuk mempin versi alat tertentu ke proyek Anda:

Memin Node.js

Untuk menentukan versi Node.js mana yang harus digunakan proyek Anda:

volta pin node@16.14.2

Anda juga dapat mempin ke versi utama atau minor, dan Volta akan menggunakan versi terbaru yang cocok:

volta pin node@16

Memin Package Manager

Demikian pula, Anda dapat mempin versi npm dan Yarn:

volta pin npm@8.5.0
volta pin yarn@1.22.18

Cara Kerja Pinning

Saat Anda mempin versi alat, Volta:

1. Memperbarui file package.json proyek Anda dengan bagian volta
2. Menyimpan informasi ini ke version control
3. Memastikan semua orang di tim Anda menggunakan versi yang sama

Berikut adalah tampilan bagian volta di package.json Anda:

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

Alat Lokal Proyek

Volta juga menghormati instalasi alat lokal proyek:

Menggunakan Biner Paket Lokal

Saat Anda menginstal paket secara lokal dalam proyek Anda:

npm install typescript
# atau
yarn add typescript

Anda dapat menjalankan biner mereka melalui Volta:

volta run tsc
# atau cukup
tsc

Volta akan menggunakan versi Node.js yang dipin oleh proyek untuk menjalankan alat ini.

Dukungan Workspace

Untuk pengaturan monorepo dengan beberapa proyek, Volta mendukung pewarisan konfigurasi:

Memperluas Konfigurasi

Dalam workspace dengan beberapa proyek, Anda dapat mengatur konfigurasi dasar di package.json root:

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

Kemudian di file package.json proyek individual, perluas konfigurasi root:

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

Ini memungkinkan Anda untuk mempertahankan versi alat yang konsisten di seluruh semua proyek dalam workspace Anda.

Praktik Terbaik untuk Manajemen Proyek

Berikut adalah beberapa praktik yang direkomendasikan untuk mengelola proyek dengan Volta:

1. Selalu Pin Alat Anda

Pin versi Node.js dan package manager untuk setiap proyek:

volta pin node
volta pin npm
# atau
volta pin yarn

Ini memastikan lingkungan pengembangan yang konsisten untuk semua anggota tim.

2. Komit Konfigurasi Volta

Selalu komit bagian volta di package.json Anda ke version control. Ini adalah cara Volta berbagi konfigurasi dengan tim Anda.

3. Mendokumentasikan Persyaratan Alat

Di README proyek Anda, sebutkan bahwa Anda menggunakan Volta untuk manajemen alat:

## Development

Proyek ini menggunakan [Volta](https://volta.sh) untuk memastikan alat yang konsisten.
Instal Volta, dan versi Node.js dan npm yang benar akan digunakan secara otomatis.

4. Menggunakan Integrasi CI/CD

Dalam lingkungan continuous integration, instal Volta sebagai bagian dari proses build Anda:

# Contoh untuk GitHub Actions
- name: Install Volta
  uses: volta-cli/action@v1

# Volta akan secara otomatis menggunakan versi Node.js dan npm/yarn yang benar
- name: Install dependencies
  run: npm install

5. Menstandarkan Antar Proyek

Untuk organisasi dengan beberapa proyek, standarkan versi alat jika memungkinkan untuk meminimalkan jumlah versi yang perlu diinstal oleh pengembang.

Dengan mengelola proyek Anda secara efektif dengan Volta, Anda memastikan bahwa semua anggota tim memiliki lingkungan pengembangan yang konsisten, mengurangi masalah "berfungsi di mesin saya" dan membuat kolaborasi lebih lancar.