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。

先决条件

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

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

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

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

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

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

要求

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

另请参阅

• 工具安装程序