UseRubyVersion@0 - 使用 Ruby 版本 v0 工作

發行項
05/16/2024

使用此工作來選取在代理程式上執行的 Ruby 版本。或者，工作可以將 Ruby 版本新增至 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.

輸入

versionSpec - 版本規格
string. 必要。預設值：>= 2.4。

指定要使用之 Ruby 版本的版本範圍或版本。

addToPath - 新增至 PATH
boolean. 預設值：true。

選擇性。在 PATH 環境變數前面加上擷取的 Ruby 版本，使其可在後續的工作或腳本中使用，而不使用輸出變數。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制項選項和一般工作屬性。

輸出變數

此工作會定義下列輸出變數，您可以在下游步驟、作業和階段中取用這些變數。

rubyLocation
Ruby 散發套件的已解析資料夾。

備註

使用此工作來選取要在代理程式上執行的 Ruby 版本，並選擇性地將其新增至 PATH。

必要條件

已安裝並存 Ruby 版本的 Microsoft 裝載代理程式，或已設定 (的 Agent.ToolsDirectory 自我裝載代理程式，請參閱常見問題) 。

如果在中 Agent.ToolsDirectory 找不到 Ruby 版本，此工作將會失敗。請參閱 Microsoft 裝載的代理程式上其他可用的 Ruby 版本。

我可以在哪裡深入瞭解工具安裝程式？

如需工具安裝程式和範例的說明，請參閱工具安裝程式。

如何設定自我裝載代理程式以使用此工作？

您可以使用自己的 Ruby 版本，在自我裝載代理程式上執行這項工作。若要在自我裝載代理程式上執行這項工作，請遵循工具快取指示進行設定 Agent.ToolsDirectory 。要使用的工具名稱是 Ruby 。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
執行于	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	此工作會使用下列命令限制來執行：受限制
Settable 變數	此工作具有設定下列變數的許可權：rubyLocation、PATH
代理程式版本	2.182.1 或更新版本
工作類別	工具

需求	描述
管線類型	YAML、傳統組建、傳統版本
執行于	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	2.115.0 或更新版本
工作類別	工具

另請參閱

工具安裝程式

共用方式為