Verwalten Sie Ihr Projekt

Volta ermöglicht es Teams und Mitarbeitern, die Entwicklungstools zu standardisieren, die sie für ihre Projekte verwenden. Dieser Leitfaden zeigt Ihnen, wie Sie Ihre Projekte effektiv mit Volta verwalten.

Tool-Versionen festlegen

Die wichtigste Projektverwaltungsfunktion in Volta ist die Möglichkeit, spezifische Tool-Versionen an Ihr Projekt zu binden:

Node.js festlegen

Um zu spezifizieren, welche Node.js-Version Ihr Projekt verwenden soll:

volta pin node@16.14.2

Sie können auch an eine Haupt- oder Nebenversion binden, und Volta wird die neueste passende Version verwenden:

volta pin node@16

Paketmanager festlegen

Ebenso können Sie npm- und Yarn-Versionen festlegen:

volta pin npm@8.5.0
volta pin yarn@1.22.18

Wie das Festlegen funktioniert

Wenn Sie eine Tool-Version festlegen, führt Volta folgende Aktionen aus:

1. Aktualisiert die package.json-Datei Ihres Projekts mit einem volta-Abschnitt
2. Committet diese Information in die Versionskontrolle
3. Stellt sicher, dass jeder in Ihrem Team die gleichen Versionen verwendet

So sieht der volta-Abschnitt in Ihrer package.json aus:

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

Projektlokale Tools

Volta respektiert auch projektlokale Tool-Installationen:

Lokale Paket-Binärdateien verwenden

Wenn Sie Pakete lokal in Ihrem Projekt installieren:

npm install typescript
# oder
yarn add typescript

Können Sie deren Binärdateien über Volta ausführen:

volta run tsc
# oder einfach
tsc

Volta wird die festgelegte Node.js-Version des Projekts verwenden, um diese Tools auszuführen.

Workspaces-Unterstützung

Für Monorepo-Setups mit mehreren Projekten unterstützt Volta Konfigurationsvererbung:

Konfigurationen erweitern

In einem Workspace mit mehreren Projekten können Sie eine Basiskonfiguration in der Root-package.json einrichten:

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

Dann in individuellen Projekt-package.json-Dateien die Root-Konfiguration erweitern:

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

Dies ermöglicht es Ihnen, konsistente Tool-Versionen über alle Projekte in Ihrem Workspace hinweg aufrechtzuerhalten.

Best Practices für Projektverwaltung

Hier sind einige empfohlene Praktiken für die Verwaltung von Projekten mit Volta:

1. Legen Sie immer Ihre Tools fest

Legen Sie Node.js- und Paketmanager-Versionen für jedes Projekt fest:

volta pin node
volta pin npm
# oder
volta pin yarn

Dies stellt konsistente Entwicklungsumgebungen für alle Teammitglieder sicher.

2. Committen Sie die Volta-Konfiguration

Committen Sie immer den volta-Abschnitt in Ihrer package.json in die Versionskontrolle. So teilt Volta die Konfiguration mit Ihrem Team.

3. Dokumentieren Sie Tool-Anforderungen

Erwähnen Sie in der README Ihres Projekts, dass Sie Volta für die Tool-Verwaltung verwenden:

## Entwicklung

Dieses Projekt verwendet [Volta](https://volta.sh), um konsistente Tools sicherzustellen.
Installieren Sie Volta, und die korrekten Versionen von Node.js und npm werden automatisch verwendet.

4. Verwenden Sie CI/CD-Integration

In kontinuierlichen Integrationsumgebungen installieren Sie Volta als Teil Ihres Build-Prozesses:

# Beispiel für GitHub Actions
- name: Install Volta
  uses: volta-cli/action@v1

# Volta wird automatisch die korrekten Node.js- und npm/yarn-Versionen verwenden
- name: Install dependencies
  run: npm install

5. Standardisieren Sie projektübergreifend

Für Organisationen mit mehreren Projekten standardisieren Sie nach Möglichkeit auf Tool-Versionen, um die Anzahl der Versionen zu minimieren, die Entwickler installieren müssen.

Durch effektive Verwaltung Ihrer Projekte mit Volta stellen Sie sicher, dass alle Teammitglieder konsistente Entwicklungsumgebungen haben, reduzieren "funktioniert auf meinem Rechner"-Probleme und machen die Zusammenarbeit reibungsloser.