UseRubyVersion@0 – Usar a tarefa ruby versão v0

Use essa tarefa para selecionar uma versão do Ruby para ser executada em um agente. Opcionalmente, a tarefa pode adicionar a versão do Ruby ao PATH.

Sintaxe

# 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.

Entradas

versionSpec - Especificação de versão
string. Obrigatórios. Valor padrão: >= 2.4.

Especifica o intervalo de versão ou uma versão de uma versão do Ruby a ser usada.

addToPath - Adicionar a PATH
boolean. Valor padrão: true.

Opcional. Anexa a versão do Ruby recuperada à variável de ambiente PATH para disponibilizá-la em tarefas ou scripts subsequentes sem usar a variável de saída.

Opções de controle de tarefa

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

Variáveis de saída

Essa tarefa define as variáveis de saída a seguir, que você pode consumir em etapas downstream, trabalhos e estágios.

rubyLocation
A pasta resolvida da distribuição ruby.

Comentários

Use essa tarefa para selecionar uma versão do Ruby a ser executada em um agente e, opcionalmente, adicioná-la ao PATH.

Pré-requisitos

• Um agente hospedado pela Microsoft com versões lado a lado do Ruby instaladas ou um agente auto-hospedado com Agent.ToolsDirectory configurado (consulte perguntas frequentes).

Essa tarefa falhará se nenhuma versão do Ruby for encontrada em Agent.ToolsDirectory. Confira outras versões do Ruby disponíveis em agentes hospedados pela Microsoft.

Onde posso saber mais sobre instaladores de ferramentas?

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

Como posso configurar um agente auto-hospedado para usar essa tarefa?

Você pode executar essa tarefa em um agente auto-hospedado com suas próprias versões do Ruby. Para executar essa tarefa em um agente auto-hospedado, configure seguindo Agent.ToolsDirectory as instruções do Cache de Ferramentas. O nome da ferramenta a ser usado é Ruby.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Executa em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando	Essa tarefa é executada usando as seguintes restrições de comando: restrito
Variáveis configuráveis	Essa 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

Confira também

• Instaladores de ferramentas