NodeTool@0 – tarefa do instalador de ferramentas Node.js v0

Utilize esta tarefa para localizar, transferir e colocar em cache uma versão especificada do Node.js e adicioná-la ao PATH.

Existe uma versão mais recente da tarefa disponível. Para obter mais informações, veja 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.

Entradas

versionSource - Origem da versão
string. Obrigatório. Valores permitidos: spec (Especifique a versão do Nó) fromFile (Obter a versão do ficheiro). Valor predefinido: spec.

versionSpec - Especificação de Versão
string. Opcional. Utilize quando versionSource = spec. Valor predefinido: 6.x.

Especifica a especificação de versão da versão a obter. Exemplos: 6.x, , 4.x, >=6.10.06.10.0.

versionFilePath - Caminho para o ficheiro .nvmrc
string. Opcional. Utilize quando versionSource = fromFile.

Caminho do ficheiro para obter a versão. Exemplo: src/.nvmrc.

checkLatest - Procurar a Versão Mais Recente
boolean. Valor predefinido: false.

Especifica o agente para verificar a versão mais recente disponível que satisfaça as especificações da versão. Por exemplo, selecione esta opção porque executa esta compilação no seu agente autoalojado e quer utilizar sempre a versão mais recente 6.x .

Dica

Se estiver a utilizar os agentes alojados na Microsoft, deve deixar esta opção definida como false. A Microsoft atualiza regularmente os agentes alojados na Microsoft, mas, muitas vezes, estão ligeiramente atrás da versão mais recente. Ativar este parâmetro pode fazer com que a compilação passe muito tempo a atualizar para uma versão secundária mais recente.

force32bit - Utilizar a versão de 32 bits em agentes x64
boolean. Valor predefinido: false.

Instala a x86 versão do Node, independentemente da arquitetura da CPU do agente.

nodejsMirror - Definir origem para binários de Node.js
string. Valor predefinido: https://nodejs.org/dist.

Utilize um espelho de instalação alternativo ao fornecer os binários Node.js.

retryCountOnDownloadFails - Definir a contagem de repetições quando as transferências de nós falharam
string. Valor predefinido: 5.

Utilize esta opção quando a tarefa não conseguiu transferir binários de nós a partir do espelho. A tarefa tentará novamente transferir os binários para as horas especificadas.

delayBetweenRetries - Definir o atraso entre repetições
string. Valor predefinido: 1000.

Utilize esta opção para definir o atraso entre repetições em milissegundos. O valor predefinido é 1000 milissegundos.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Existe uma versão mais recente da tarefa disponível. Para obter mais informações, veja UseNode@1.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agent, DeploymentGroup
Exigências	Nenhuma
Capacidades	A execução desta tarefa satisfaz as seguintes exigências para quaisquer tarefas subsequentes no mesmo trabalho: Node, npm, node.js
Restrições de comandos	Esta tarefa é executada com as seguintes restrições de comando: restritas
Variáveis de definição	Esta tarefa tem permissão para definir as seguintes variáveis: PATH
Versão do agente	2.182.1 ou superior
Categoria da tarefa	Ferramenta

Ver também

Para obter uma explicação dos instaladores de ferramentas e exemplos, veja Instaladores de ferramentas.