UseNode@1 – Usar a tarefa Node.js ecossistema v1

2025-06-24

Use essa tarefa para localizar, baixar e armazenar em cache uma versão especificada do Node.js e adicioná-la ao PATH. Essa tarefa também fornece suporte a proxy.

Sintaxe

# Use Node.js ecosystem v1
# Set up a Node.js environment and add it to the PATH, additionally providing proxy support.
- task: UseNode@1
  inputs:
    #version: '10.x' # string. Version. Default: 10.x.
    #checkLatest: false # boolean. Check for Latest Version. Default: false.
    #force32bit: false # boolean. Use 32 bit version on x64 agents. Default: false.
  # advanced
    #retryCountOnDownloadFails: '5' # string. Set retry count when nodes downloads failed. Default: 5.
    #delayBetweenRetries: '1000' # string. Set delay between retries. Default: 1000.

# Use Node.js ecosystem v1
# Set up a Node.js environment and add it to the PATH, additionally providing proxy support.
- task: UseNode@1
  inputs:
    #version: '10.x' # string. Version. Default: 10.x.
    #checkLatest: false # boolean. Check for Latest Version. Default: false.
    #force32bit: false # boolean. Use 32 bit version on x64 agents. Default: false.

# Use Node.js ecosystem v1
# Set up a Node.js environment and add it to the PATH, additionally providing proxy support.
- task: UseNode@1
  inputs:
    #version: '10.x' # string. Version. Default: 10.x.
    #checkLatest: false # boolean. Check for Latest Version. Default: false.

Entradas

version - versão
string. Valor padrão: 10.x.

Obrigatório Especifica a versão Node.js usando a sintaxe do intervalo de versões do SemVer. Exemplos: 10.x, 10.15.1, >=10.15.0.

checkLatest - verificar se há de versão mais recente
boolean. Valor padrão: false.

Verifica online a versão mais recente disponível que satisfaz a especificação de versão. Isso deve ser false, a menos que você precise sempre ter a versão mais recente. Definir o valor como true fará com que a tarefa incorra em custos de download que podem ser desnecessários, especialmente com o pool de build hospedado.

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

Instala a versão x86 do Node.js em um agente do Windows de 64 bits. Só funciona em agentes do Windows.

retryCountOnDownloadFails - Definir contagem de repetições quando os downloads de nós falharem
string. Valor padrão: 5.

Use essa opção quando a tarefa não tiver baixado binários de nó do espelho. A tarefa tentará baixar novamente os binários para os horários especificados.

delayBetweenRetries - Definir atraso entre novas tentativas
string. Valor padrão: 1000.

Use essa opção para definir o atraso entre repetições em milissegundos. O default-value é 1.000 milissegundos.

Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
recursos	Executar essa tarefa atende às seguintes demandas de para todas as tarefas subsequentes no mesmo trabalho: Nó, npm, node.js
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	2.144.0 ou superior
Categoria de tarefa	Ferramenta