Gestire il tuo progetto

Volta permette ai team e ai collaboratori di standardizzare gli strumenti di sviluppo che usano per i loro progetti. Questa guida ti mostrerà come usare Volta per gestire efficacemente i tuoi progetti.

Fissare le versioni degli strumenti

La funzionalità più importante di gestione dei progetti in Volta è la capacità di fissare versioni specifiche di strumenti al tuo progetto:

Fissare Node.js

Per specificare quale versione di Node.js dovrebbe usare il tuo progetto:

volta pin node@16.14.2

Puoi anche fissare a una versione principale o secondaria, Volta userà l'ultima versione corrispondente:

volta pin node@16

Fissare i gestori di pacchetti

Allo stesso modo, puoi fissare le versioni di npm e Yarn:

volta pin npm@8.5.0
volta pin yarn@1.22.18

Come funziona il fissaggio

Quando fissi le versioni degli strumenti, Volta:

1. Aggiorna il file package.json del tuo progetto con una sezione volta
2. Committa queste informazioni al controllo versione
3. Assicura che tutti nel team usino le stesse versioni

Ecco come apparirà la sezione volta nel tuo package.json:

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

Strumenti locali del progetto

Volta rispetta anche le installazioni locali di strumenti del progetto:

Usare binari di pacchetti locali

Quando installi pacchetti localmente nel tuo progetto:

npm install typescript
# o
yarn add typescript

Puoi eseguire i loro binari tramite Volta:

volta run tsc
# o semplicemente
tsc

Volta userà la versione di Node.js fissata dal progetto per eseguire questi strumenti.

Supporto workspace

Per configurazioni monorepo con più progetti, Volta supporta l'ereditarietà della configurazione:

Configurazione estesa

In un workspace con più progetti, puoi impostare la configurazione di base nel package.json root:

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

Poi nei file package.json dei singoli progetti, estendi la configurazione root:

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

Questo ti permette di mantenere versioni coerenti degli strumenti tra tutti i progetti nel workspace.

Best practice per la gestione dei progetti

Ecco alcune pratiche raccomandate per gestire progetti con Volta:

1. Fissa sempre i tuoi strumenti

Fissa le versioni di Node.js e gestore di pacchetti per ogni progetto:

volta pin node
volta pin npm
# o
volta pin yarn

Questo assicura che tutti i membri del team abbiano un ambiente di sviluppo coerente.

2. Committa la configurazione Volta

Commetti sempre la sezione volta nel package.json al controllo versione. Questo è il modo in cui Volta condivide la configurazione con il tuo team.

3. Documenta i requisiti degli strumenti

Nel README del tuo progetto, menziona che usi Volta per la gestione degli strumenti:

## Sviluppo

Questo progetto usa [Volta](https://volta.sh) per assicurare coerenza degli strumenti.
Installa Volta e userà automaticamente le versioni corrette di Node.js e npm.

4. Usa l'integrazione CI/CD

Negli ambienti di integrazione continua, installa Volta come parte del processo di build:

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

# Volta userà automaticamente le versioni corrette di Node.js e npm/yarn
- name: Install dependencies
  run: npm install

5. Standardizzazione tra progetti

Per organizzazioni con più progetti, standardizza le versioni degli strumenti quando possibile per minimizzare il numero di versioni che i sviluppatori devono installare.

Usando Volta per gestire efficacemente i tuoi progetti, assicuri che tutti i membri del team abbiano un ambiente di sviluppo coerente, riduci i problemi "funziona sulla mia macchina" e rendi la collaborazione più fluida.