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.
# 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.
# 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:
    versionSpec: '6.x' # string. Required. Version Spec. Default: 6.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 v0
# Finds or downloads and caches the specified version spec of Node.js and adds it to the PATH.
- task: NodeTool@0
  inputs:
    versionSpec: '6.x' # string. Required. Version Spec. Default: 6.x.
    #checkLatest: false # boolean. Check for Latest Version. Default: false.
# Use Node.js ecosystem v0
# Finds or Downloads and caches specified version spec of Node and adds it to the PATH.
- task: NodeTool@0
  inputs:
    versionSpec: '6.x' # string. Required. Version Spec. Default: 6.x.
    #checkLatest: false # boolean. Check for Latest Version. Default: false.

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.


versionSpec - Especificação de Versão
string. Obrigatório. 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
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 Qualquer
Variáveis de definição Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria da tarefa Ferramenta
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
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria da tarefa Ferramenta
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: Nó
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria da tarefa Ferramenta

Ver também

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