NodeTool@0 - tâche v0 du programme d’installation de l’outil Node.js

Utilisez cette tâche pour rechercher, télécharger et mettre en cache une version spécifiée de Node.js et l’ajouter à PATH.

Une version plus récente de la tâche est disponible. Pour plus d’informations, consultez 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.

Entrées

versionSource - Source de la version
string. Obligatoire. Valeurs autorisées : spec (Spécifier la version du nœud), fromFile (Obtenir la version à partir d’un fichier). Valeur par défaut : spec.

versionSpec - Spécification de version
string. facultatif. Utilisez quand versionSource = spec. Valeur par défaut : 6.x.

Spécifie la spec de version de la version à obtenir. Exemples : 6.x, 4.x, 6.10.0, >=6.10.0.

versionFilePath - Chemin d’accès au fichier .nvmrc
string. facultatif. Utilisez quand versionSource = fromFile.

Chemin d’accès au fichier pour obtenir la version. Exemple : src/.nvmrc.

checkLatest - Rechercher la dernière version
boolean. Valeur par défaut : false.

Spécifie l’agent à case activée pour la dernière version disponible qui répond aux spécifications de version. Par exemple, vous sélectionnez cette option, car vous exécutez cette build sur votre agent auto-hébergé et que vous souhaitez toujours utiliser la dernière 6.x version.

Conseil

Si vous utilisez les agents hébergés par Microsoft, vous devez laisser cette valeur définie sur false. Microsoft met régulièrement à jour les agents hébergés par Microsoft, mais ils sont souvent légèrement en retard sur la dernière version. L’activation de ce paramètre peut entraîner la mise à jour de votre build vers une version mineure plus récente.

force32bit - Utiliser la version 32 bits sur les agents x64
boolean. Valeur par défaut : false.

Installe la x86 version de Node, quelle que soit l’architecture du processeur de l’agent.

nodejsMirror - Définir la source pour les fichiers binaires Node.js
string. Valeur par défaut : https://nodejs.org/dist.

Utilisez un autre miroir d’installation lors de l’approvisionnement des fichiers binaires Node.js.

retryCountOnDownloadFails - Définir le nombre de nouvelles tentatives en cas d’échec des téléchargements de nœuds
string. Valeur par défaut : 5.

Utilisez cette option lorsque la tâche n’a pas pu télécharger les fichiers binaires de nœud à partir du miroir. La tâche réessayera de télécharger les fichiers binaires pour les heures spécifiées.

delayBetweenRetries - Définir le délai entre les nouvelles tentatives
string. Valeur par défaut : 1000.

Utilisez cette option pour définir le délai entre les nouvelles tentatives en millisecondes. La valeur par défaut est 1 000 millisecondes.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Une version plus récente de la tâche est disponible. Pour plus d’informations, consultez UseNode@1.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	L’exécution de cette tâche répond aux exigences suivantes pour toutes les tâches suivantes dans le même travail : Node, npm, node.js
Restrictions de commandes	Cette tâche s’exécute à l’aide des restrictions de commande suivantes : restricted
Variables settables	Cette tâche est autorisée à définir les variables suivantes : PATH
Version de l’agent	2.182.1 ou version ultérieure
Catégorie de la tâche	Outil

Voir aussi

Pour obtenir une explication sur les programmes d’installation d’outils et des exemples, consultez Programmes d’installation des outils.