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 バージョンのバージョン範囲またはバージョンを指定します。

pathに追加する addToPath -
boolean. 既定値: true.

任意 取得した Ruby バージョンを PATH 環境変数の先頭に追加して、出力変数を使用せずに後続のタスクまたはスクリプトで使用できるようにします。

タスク コントロールのオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。

出力変数

このタスクでは、次の 出力変数を定義します。この変数は、ダウンストリームのステップ、ジョブ、およびステージで使用できます。

rubyLocation
Ruby ディストリビューションの解決済みフォルダー。

注釈

このタスクを使用して、エージェントで実行する Ruby のバージョンを選択し、必要に応じて PATH に追加します。

前提条件

• サイド バイ サイド バージョンの Ruby がインストールされた の Microsoft ホスト型エージェント、または Agent.ToolsDirectory が構成されたセルフホステッド エージェント (FAQ 参照)。

Agent.ToolsDirectoryで Ruby のバージョンが見つからない場合、このタスクは失敗します。 Microsoft でホストされるエージェント 、他の使用可能な Ruby バージョンを参照してください。

ツール インストーラーの詳細については、どこで確認できますか?

ツール インストーラーと例の説明については、「ツール インストーラーのを参照してください。

このタスクを使用するようにセルフホステッド エージェントを構成するにはどうすればよいですか?

このタスクは、独自の Ruby バージョンのセルフホステッド エージェントで実行できます。 セルフホステッド エージェントでこのタスクを実行するには、ツール キャッシュの手順に従って Agent.ToolsDirectory を設定。 使用するツール名は Ruby。

必要条件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行日	エージェント、DeploymentGroup
の需要	なし
機能の	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	このタスクは、次の コマンド制限: restricted を使用して実行されます。
設定可能な変数	このタスクには、rubyLocation、PATH 次の変数を設定する権限があります。
エージェントのバージョン	2.182.1 以上
タスク カテゴリ	道具

こちらもご覧ください

• ツールインストーラーの