NodeTool@0 – Node.js Tool installer v0 task

Verwenden Sie diese Aufgabe, um eine angegebene Version von Node.js zu suchen, herunterzuladen und zwischenzuspeichern und dem PATH hinzuzufügen.

Es ist eine neuere Version der Aufgabe verfügbar. Weitere Informationen finden Sie unter UseNode@1.

Syntax

# Use Node.js ecosystem v0
# Finds or downloads and caches the specified version spec of Node.js and adds it to the PATH.
- task: NodeTool@0
  inputs:
    versionSource: 'spec' # 'spec' | 'fromFile'. Required. Source of version. Default: spec.
    #versionSpec: '6.x' # string. Optional. Use when versionSource = spec. Version Spec. Default: 6.x.
    #versionFilePath: # string. Optional. Use when versionSource = fromFile. Path to the .nvmrc file. 
    #checkLatest: false # boolean. Check for Latest Version. Default: false.
    #force32bit: false # boolean. Use 32 bit version on x64 agents. Default: false.
  # Advanced
    #nodejsMirror: 'https://nodejs.org/dist' # string. Set source for Node.js binaries. Default: https://nodejs.org/dist.
    #retryCountOnDownloadFails: '5' # string. Set retry count when nodes downloads failed. Default: 5.
    #delayBetweenRetries: '1000' # string. Set delay between retries. Default: 1000.

Eingänge

versionSource - Quelle der Version
string. Erforderlich. Zulässige Werte: spec (Knotenversion angeben), fromFile (Version aus Datei abrufen). Standardwert: spec.

versionSpec - Versionsspezifikation
string. Wahlfrei. Wird verwendet, wenn versionSource = spec. Standardwert: 6.x.

Gibt die Versionsspezifikation der abzurufenden Version an. Beispiele: 6.x, 4.x, 6.10.0, >=6.10.0.

versionFilePath - Pfad zur NVMRC-Datei
string. Wahlfrei. Wird verwendet, wenn versionSource = fromFile.

Dateipfad zum Abrufen der Version. Beispiel: src/.nvmrc.

checkLatest - Auf neueste Version überprüfen
boolean. Standardwert: false.

Gibt den Agent an, der auf die neueste verfügbare Version überprüft werden soll, die die Versionsspezifikation erfüllt. Sie wählen diese Option beispielsweise aus, da Sie diesen Build auf Ihrem selbst gehosteten Agent-ausführen und immer die neueste 6.x Version verwenden möchten.

Tipp

Wenn Sie von Microsoft gehosteten Agentsverwenden, sollten Sie diesen Satz auf falselassen. Microsoft aktualisiert die von Microsoft gehosteten Agents regelmäßig, aber sie sind häufig etwas hinter der neuesten Version. Das Aktivieren dieses Parameters kann dazu führen, dass Ihr Build viel Zeit mit dem Aktualisieren auf eine neuere Nebenversion verbringt.

force32bit - Verwenden der 32-Bit-Version für x64-Agents
boolean. Standardwert: false.

Installiert die x86 Version von Node unabhängig von der CPU-Architektur des Agents.

nodejsMirror - Festlegen der Quelle für Node.js Binärdateien
string. Standardwert: https://nodejs.org/dist.

Verwenden Sie einen alternativen Installationsspiegel, wenn Sie die Node.js Binärdateien beziehen.

retryCountOnDownloadFails - Festlegen der Wiederholungsanzahl, wenn knotendownloads fehlgeschlagen
string. Standardwert: 5.

Verwenden Sie diese Option, wenn die Aufgabe keine Knotenbinärdateien aus der Spiegelung herunterladen konnte. Die Aufgabe versucht erneut, die Binärdateien für die angegebenen Zeiten herunterzuladen.

delayBetweenRetries - Festlegen der Verzögerung zwischen Wiederholungen
string. Standardwert: 1000.

Verwenden Sie diese Option, um die Verzögerung zwischen Wiederholungen in Millisekunden festzulegen. Der Standardwert ist 1000 Millisekunden.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Bemerkungen

Es ist eine neuere Version der Aufgabe verfügbar. Weitere Informationen finden Sie unter UseNode@1.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Die Ausführung dieser Aufgabe erfüllt die folgenden Anforderungen für alle nachfolgenden Aufgaben im selben Auftrag: Node, npm, node.js
Befehlseinschränkungen	Diese Aufgabe wird mit den folgenden Befehlseinschränkungenausgeführt: restricted
Settable-Variablen	Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen : PATH
Agentversion	2.182.1 oder höher
Vorgangskategorie	Werkzeug

Siehe auch

Eine Erläuterung von Toolinstallationsprogrammen und Beispielen finden Sie unter Tool installers.