Skip to content

Node-Versionen festsetzen

Eine der mächtigsten Funktionen von Volta ist die Möglichkeit, spezifische Tool-Versionen an Ihr Projekt zu binden und sicherzustellen, dass jeder, der an dem Projekt arbeitet, exakt dieselbe Toolchain verwendet.

Warum Versionen festlegen?

  • Konsistenz: Jeder in Ihrem Team verwendet dieselben Versionen
  • Reproduzierbarkeit: Build-Umgebungen entsprechen Entwicklungsumgebungen
  • Zuverlässigkeit: Keine Überraschungen durch unerwartetes Tool-Verhalten
  • Onboarding: Neue Teammitglieder erhalten automatisch die richtige Einrichtung

Node.js festlegen

Um eine spezifische Node.js-Version an Ihr Projekt zu binden:

bash
volta pin node@16.14.2

Dieser Befehl:

  1. Lädt Node.js 16.14.2 herunter und installiert es (falls noch nicht vorhanden)
  2. Aktualisiert Ihre package.json mit einem volta-Abschnitt
  3. Sorgt dafür, dass das Projekt Node.js 16.14.2 verwendet, wann immer Sie node im Projektverzeichnis ausführen

Ihre package.json wird nun enthalten:

json
{
  "volta": {
    "node": "16.14.2"
  }
}

Paketmanager festlegen

Sie können auch spezifische Versionen von Paketmanagern festlegen:

bash
volta pin npm@8.5.0
volta pin yarn@1.22.18
volta pin pnpm@7.0.0

Dies stellt sicher, dass jeder dieselbe Paketmanager-Version verwendet und verhindert Lockfile-Inkonsistenzen und andere Versionsprobleme.

Nach dem Festlegen von npm wird Ihre package.json so aussehen:

json
{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  }
}

Festgelegte Tools verwenden

Sobald Tools festgelegt sind, sind keine zusätzlichen Befehle erforderlich. Navigieren Sie einfach zu Ihrem Projektverzeichnis und führen Sie Befehle normal aus:

bash
# Diese werden Ihre festgelegten Projektversionen verwenden
node --version
npm --version

Volta erkennt automatisch, wenn Sie sich in einem Verzeichnis mit festgelegten Versionen befinden und verwendet diese anstelle Ihrer Standard-Tools.

Festgelegte Versionen aktualisieren

Um eine festgelegte Version zu aktualisieren:

bash
volta pin node@latest
volta pin npm@latest

Oder spezifizieren Sie eine neue Version:

bash
volta pin node@18

Best Practices

Wann festlegen

  • Für Produktionsanwendungen: Legen Sie immer sowohl Node als auch Ihren Paketmanager fest
  • Für Bibliotheken/Pakete: Legen Sie Node fest, wenn Ihr Code auf spezifische Node-Funktionen angewiesen ist
  • Für Tools/Utilities: Legen Sie die minimal erforderliche Node-Version für die Funktionalität fest

Versionsauswahl

  • Für Anwendungen wählen Sie eine LTS (Long Term Support) Version von Node
  • Für Bibliotheken verwenden Sie die älteste Node-Version, die Sie unterstützen möchten
  • Aktualisieren Sie regelmäßig Versionen, um von Sicherheitsfixes zu profitieren

CI/CD-Integration

Stellen Sie sicher, dass Ihre CI/CD-Pipelines Ihre festgelegten Versionen respektieren:

  • Verwenden Sie die Volta GitHub Action in GitHub-Workflows
  • Für andere CI-Systeme installieren Sie Volta und es wird automatisch Ihre festgelegten Versionen verwenden