UseDotNet@2 - dotnet v2 タスクを使用する

このタスクを使用して、インターネットまたはローカル キャッシュから特定のバージョンの .NET Core SDK を取得し、PATH に追加します。 このタスクを使用して、後続のタスクで使用される .NET Core のバージョンを変更します。 このタスクでは、プロキシのサポートも提供されます。

構文

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

入力

パッケージを packageType - して をインストールする
string. 使用できる値: runtime、sdk (SDK (ランタイムを含む))。 既定値: sdk.

.NET ランタイムと SDK のどちらをインストールするかを指定します。

useGlobalJson - グローバル json を使用する
boolean. 随意。 packageType = sdkするときに使用します。 既定値: false.

global.json ファイルからすべての SDK をインストールします。 これらのファイルは、system.DefaultWorkingDirectoryから検索されます. 作業ディレクトリ入力を設定することで、検索ルート パスを変更できます。

UseDotNet@2.version 入力で説明されている 6.x 形式と 6.1.x 形式 (ワイルドカードとして .x を使用) は、global.jsonの sdk.version パラメーターではなく、タスクの version 入力で使用されます。

##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. のようなエラー メッセージが表示され、global.jsonを使用している場合は、global.jsonの sdk.version を確認します。

global.jsonの詳細については、「.NET バージョンを選択してを使用する」を参照してください。

workingDirectory - 作業ディレクトリの
string. 随意。 useGlobalJson = trueするときに使用します。

useGlobalJsonを使用するときに global.json ファイルを検索するパスを指定します。 値が空の場合、system.DefaultWorkingDirectory はルート パスと見なされます。

version - バージョン
string. 随意。 useGlobalJson = false || packageType = runtimeするときに使用します。

インストールする .NET Core SDK またはランタイムのバージョンを指定します。 バージョン値の形式は、次の例で示されています。

• 2.x: 指定したメジャー バージョンの最新の SDK またはランタイムをインストール 2。
• 3.1.x: 指定されたメジャー バージョンとマイナー バージョン、3、1を使用して、最新の SDK またはランタイムをインストールします。
• 3.1.402: 指定した SDK またはランタイム バージョンをインストール 3.1.402。

SDK またはランタイム インストールのバージョン値は、releases.json ファイルにあります。 メジャー/マイナー バージョンの releases.json へのリンクは、releases-index ファイルにあります。 たとえば、バージョン 3.1 の releases.json ファイルへのリンク。

互換性のある Visual Studio バージョン を する
string.

対応する .NET Core SDK のインストールに対応する Visual Studio バージョンを指定します。 値は、メジャー バージョン、マイナー バージョン、パッチ番号を含む 16.6.4などの完全なバージョン番号である必要があります。

version 文字列に使用される SDK またはランタイム インストールのバージョン値は、releases.json ファイルにあります。 メジャー/マイナー バージョンの releases.json へのリンクは、releases-index ファイルにあります。 たとえば、バージョン 3.1 の releases.json ファイルへのリンク。

プレビュー バージョンを含める includePreviewVersions -
boolean. 随意。 useGlobalJson = false || packageType = runtimeするときに使用します。 既定値: false.

trueに設定すると、タスクが最新のランタイム/SDK バージョン (2.2.x や 3.1.xの検索など) を検索するときのプレビュー バージョンが含まれます。 3.0.100-preview3-010431など、正確なバージョンを指定した場合、この設定は無視されます。

.Net Core をインストールするための パス
string. 既定値: $(Agent.ToolsDirectory)/dotnet.

.NET Core SDK/Runtime をインストールする場所を指定します。 パスが異なると、次のような影響を受けます。NET の動作。

• $(Agent.ToolsDirectory): このパスを使用すると、このディレクトリはパイプライン間でクリーンアップされないため、エージェントへのインストールがキャッシュされます。 エージェントで実行されているすべてのパイプラインは、以前にインストールされたバージョンにアクセスできます。
• $(Agent.TempDirectory): このパスを使用すると、各パイプラインの後にこのフォルダーがクリーンアップされるため、パイプラインでキャッシュされたバージョンの .NET Core が使用されないようにします。
• 別のパス: エージェント プロセスがパスにアクセスできる場合は、任意のパスを使用できます。 これにより、マシンの状態が変更され、マシン上で実行されているすべてのプロセスに影響が及びます。

手記

マルチレベル参照 設定 (performMultiLevelLookup) を使用して、.NET ホストがバージョンを検索する方法を構成できます。

複数レベルの参照 を実行する
boolean. 既定値: false.

適切な共有フレームワークを検索するときの .NET ホスト プロセスの動作を構成します。 値は次のとおりです。

• false: ホスト プロセスは、タスクによって指定されたフォルダーに存在するバージョンのみを検索します。
• true: ホスト プロセスは、複数レベルの検索を使用して、定義済みのグローバルな場所で検索します。 既定のグローバルな場所は次のとおりです。
  • C:\Program Files\dotnet (64 ビット プロセス)
  • C:\Program Files (x86)\dotnet (32 ビット プロセス)

複数レベルの SharedFX ルックアップの詳細を確認します。

手記

performMultiLevelLookup は、Windows ベースのエージェントにのみ適用されます。

requestTimeout - パッケージダウンロード要求 のタイムアウトを設定する
string. 既定値: 300000.

タスクが .NET パッケージを取得するために行う HTTP 要求のタイムアウト値を指定します。 値はミリ秒単位です。 既定値は 300000 ミリ秒 (5 分) です。 600000 ミリ秒 (10 分) を超えることはできません。

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

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

出力変数

何一つ。

備考

.NET Core の使用タスクは、インターネットまたはツール キャッシュから特定のバージョンの .NET Core を取得し、それを Azure Pipelines エージェントの PATH (ホステッドまたはプライベート) に追加します。 このタスクを使用して、DotNetCoreCLI@2などの後続のタスクで使用される .NET Core のバージョンを変更します。 ビルド定義の DotNetCoreCLI@2 の前にこのタスクを追加すると、アプリのビルド、テスト、発行時にバージョンを使用できるようになります。

ツール インストーラーのアプローチでは、エージェントの更新サイクルから切り離すこともできます。 探している .NET Core のバージョンが Azure Pipelines エージェント (Hosted または Private) にない場合は、このタスクを使用して、エージェントに適切なバージョンをインストールできます。

必要条件

要件	形容
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行日	エージェント、DeploymentGroup
の需要	何一つ
機能の	このタスクを実行すると、同じジョブ内の後続のタスクに対する が必要な が満たされます。DotNetCore
コマンドの制限	任意
設定可能な変数	任意
エージェントのバージョン	2.144.0 以上
タスク カテゴリ	道具