UseRubyVersion@0 - 使用 Ruby 版本 v0 任务

使用此任务选择要在代理上运行的 Ruby 版本。 （可选）任务可以将 Ruby 版本添加到 PATH。

语法

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

输入

versionSpec - 版本规范
string. 必需。 默认值：>= 2.4。

指定要使用的 Ruby 版本的版本范围或版本。

addToPath - 添加到 PATH
boolean. 默认值：true。

可选。 将检索到的 Ruby 版本追加到 PATH 环境变量，使其在后续任务或脚本中可用，而无需使用输出变量。

任务控制选项

除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

此任务定义以下 输出变量，可在下游步骤、作业和阶段中使用。

rubyLocation
Ruby 分发的已解析文件夹。

备注

使用此任务选择要在代理上运行的 Ruby 版本，并选择性地将其添加到 PATH。

先决条件

• 安装了并行版本的 Ruby 的 Microsoft 托管代理 ，或具有 Agent.ToolsDirectory 已配置 (的自承载代理请参阅 常见问题解答) 。

如果在 中 Agent.ToolsDirectory找不到 Ruby 版本，则此任务将失败。 请参阅 Microsoft 托管代理上其他可用的 Ruby 版本。

在哪里可以了解有关工具安装程序的详细信息？

有关工具安装程序和示例的说明，请参阅 工具安装程序。

如何配置自承载代理以使用此任务？

可以使用自己的 Ruby 版本在自承载代理上运行此任务。 若要在自承载代理上运行此任务，请按照工具缓存说明进行设置Agent.ToolsDirectory。 要使用的工具名称为 Ruby。

要求

要求	说明
管道类型	YAML，经典内部版本，经典版本
运行平台	Agent、DeploymentGroup
需求	无
功能	此任务不满足作业中后续任务的任何要求。
命令限制	此任务使用以下命令 限制运行：受限
可设置的变量	此任务有权 设置以下变量：rubyLocation、PATH
代理版本	2.182.1 或更高版本
任务类别	工具

另请参阅

• 工具安装程序