Partilhar via


UseRubyVersion@0 - Utilizar a tarefa V0 da versão Ruby

Utilize esta tarefa para selecionar uma versão do Ruby para ser executada num agente. Opcionalmente, a tarefa pode adicionar a versão ruby ao PATH.

Syntax

# Use Ruby version v0
# Use the specified version of Ruby from the tool cache, optionally adding it to the PATH.
- task: UseRubyVersion@0
  inputs:
    versionSpec: '>= 2.4' # string. Required. Version spec. Default: >= 2.4.
    #addToPath: true # boolean. Add to PATH. Default: true.
# Use Ruby Version v0
# Retrieves the specified version of Ruby from the tool cache. Optionally add it to PATH.
- task: UseRubyVersion@0
  inputs:
    versionSpec: '>= 2.4' # string. Required. Version spec. Default: >= 2.4.
    #addToPath: true # boolean. Add to PATH. Default: true.

Entradas

versionSpec - Especificação da versão
string. Obrigatório. Valor predefinido: >= 2.4.

Especifica o intervalo de versões ou uma versão de uma versão ruby a utilizar.


addToPath - Adicionar ao PATH
boolean. Valor predefinido: true.

Opcional. Prepara a versão do Ruby obtida para a variável de ambiente PATH para a disponibilizar em tarefas ou scripts subsequentes sem utilizar a variável de saída.


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

Esta tarefa define as seguintes variáveis de saída, que pode consumir em passos, tarefas e fases a jusante.

rubyLocation
A pasta resolvida da distribuição Ruby.

Observações

Utilize esta tarefa para selecionar uma versão do Ruby para ser executada num agente e, opcionalmente, adicioná-la ao PATH.

Pré-requisitos

  • Um agente alojado na Microsoft com versões lado a lado do Ruby instalado ou um agente autoalojado com Agent.ToolsDirectory configurado (consulte FAQ).

Esta tarefa falhará se não forem encontradas versões ruby no Agent.ToolsDirectory. Veja outras versões do Ruby disponíveis em agentes alojados na Microsoft.

Onde posso saber mais sobre os instaladores de ferramentas?

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

Como posso configurar um agente autoalojado para utilizar esta tarefa?

Pode executar esta tarefa num agente autoalojado com as suas próprias versões ruby. Para executar esta tarefa num agente autoalojado, configure-a Agent.ToolsDirectory seguindo as instruções da Cache de Ferramentas. O nome da ferramenta a utilizar é Ruby.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agente, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Esta tarefa é executada com as seguintes restrições de comandos: restritas
Variáveis de tabelas definidas Esta tarefa tem permissão para definir as seguintes variáveis: rubyLocation, 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 Agente, DeploymentGroup
Exigências Nenhuma
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de tabelas definidas Qualquer
Versão do agente 2.115.0 ou superior
Categoria da tarefa Ferramenta

Ver também