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、傳統組建、傳統版本
執行於	Agent、DeploymentGroup
需求	沒有
功能	此工作不符合作業中後續工作的任何需求。
命令限制	此工作會使用下列 命令限制執行： 受限制
Settable 變數	此工作具有 設定下列變數的許可權：rubyLocation、PATH
代理程式版本	2.182.1 或更新
工作類別	工具

另請參閱

• 工具安裝程式