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.
# 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.
# 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.
# Advanced
#installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
#performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.
# Use dotnet 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.
#version: # string. Version.
#includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
# Advanced
#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
検索されます。 作業ディレクトリ入力を設定することで、検索ルート パスを変更できます。
6.x
入力でUseDotNet@2.version
説明されている と 6.1.x
の形式 (ワイルドカードとして使用.x
) は、 のversion
パラメーターではなくsdk.version
、タスクの入力でglobal.json
使用されます。
のような ##[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
している場合は、 sdk.version
を確認します global.json
。
の global.json
詳細については、「 使用する .NET バージョンを選択する」を参照してください。
workingDirectory
- 作業ディレクトリ
string
. 省略可能。 の場合は useGlobalJson = true
を使用します。
を使用useGlobalJson
するときにファイルを検索するパスglobal.json
を指定します。 値が空の場合、 system.DefaultWorkingDirectory
はルート パスと見なされます。
version
- バージョン
string
. 省略可能。 の場合は useGlobalJson = false || packageType = runtime
を使用します。
インストールする .NET Core SDK またはランタイムのバージョンを指定します。 バージョン値の形式は、次の例と共に示されています。
2.x
: 指定したメジャー バージョン2
() を使用して、最新の SDK またはランタイムをインストールします。3.1.x
: 指定したメジャー バージョンとマイナー バージョンと を使用して、3
1
最新の SDK またはランタイムをインストールします。3.1.402
: 指定した SDK またはランタイム バージョン3.1.402
をインストールします。
SDK またはランタイム インストールのバージョン値は、 ファイルにあります releases.json
。 メジャー/マイナー バージョンの への releases.json
リンクは、 releases-index ファイルにあります。 たとえば、 バージョン 3.1 の releases.json ファイルへのリンクです。
version
- バージョン
string
.
インストールする .NET Core SDK またはランタイムのバージョンを指定します。 バージョン値の形式は、次の例と共に示されています。
2.x
: 指定したメジャー バージョン2
() を使用して、最新の SDK またはランタイムをインストールします。3.1.x
: 指定したメジャー バージョンとマイナー バージョンと を使用して、3
1
最新の SDK またはランタイムをインストールします。3.1.402
: 指定した SDK またはランタイム バージョン3.1.402
をインストールします。
SDK またはランタイム インストールのバージョン値は、 ファイルにあります releases.json
。 メジャー/マイナー バージョンの への releases.json
リンクは、 releases-index ファイルにあります。 たとえば、 バージョン 3.1 の releases.json ファイルへのリンクです。
vsVersion
- 互換性のある 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
場合は、 や 3.1.x
の検索など、タスクが最新のランタイム/SDK バージョンを検索2.2.x
するときにプレビュー バージョンが含まれます。 など、正確なバージョンを指定した場合、 3.0.100-preview3-010431
この設定は無視されます。
includePreviewVersions
- プレビュー バージョンを含める
boolean
. 既定値: false
。
に設定されているtrue
場合は、 や 3.1.x
の検索など、タスクが最新のランタイム/SDK バージョンを検索2.2.x
するときにプレビュー バージョンが含まれます。 など、正確なバージョンを指定した場合、 3.0.100-preview3-010431
この設定は無視されます。
installationPath
- インストール.Net Coreのパス
string
. 既定値: $(Agent.ToolsDirectory)/dotnet
。
.NET Core SDK/Runtime をインストールする場所を指定します。 異なるパスは、 に次の影響を与える可能性があります。NET の動作。
$(Agent.ToolsDirectory)
: このパスを使用すると、このディレクトリはパイプライン間でクリーンアップされないため、エージェントへのインストールがキャッシュされます。 エージェントで実行されているすべてのパイプラインは、以前にインストールされたバージョンにアクセスできます。$(Agent.TempDirectory)
: このパスを使用すると、パイプラインの後にこのフォルダーがクリーンアップされるため、パイプラインでキャッシュされたバージョンの .NET Core が使用されないようにします。- 別のパス: エージェント プロセスがパスにアクセスできる場合は、任意のパスを使用できます。 これにより、マシンの状態が変更され、マシン上で実行されているすべてのプロセスに影響します。
Note
[複数レベルの参照] 設定を使用して、performMultiLevelLookup
.NET ホストがバージョンを検索する方法を構成できます。
performMultiLevelLookup
- 複数レベルの参照を実行する
boolean
. 既定値: false
。
適切な共有フレームワークを検索するときの .NET ホスト プロセスの動作を構成します。 値は次のとおりです。
false
: ホスト プロセスは、タスクで指定されたフォルダーに存在するバージョンのみを検索します。true
: ホスト プロセスは、複数レベルの検索を使用して、定義済みのグローバルな場所で検索します。 既定のグローバルな場所は次のとおりです。C:\Program Files\dotnet
(64 ビット プロセス)C:\Program Files (x86)\dotnet
(32 ビット プロセス)
複数レベルの SharedFX 参照の詳細については、こちらを参照してください。
Note
performMultiLevelLookup
は、Windows ベースのエージェントにのみ適用されます。
タスク コントロール のオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。
出力変数
[なし] :
解説
[.NET Core の使用] タスクは、インターネットまたはツール キャッシュから特定のバージョンの .NET Core を取得し、Azure Pipelines エージェント (ホストまたはプライベート) の PATH に追加します。 このタスクを使用して、DotNetCoreCLI@2などの後続のタスクで使用される .NET Core のバージョン を変更します。 ビルド定義で DotNetCoreCLI@2 の前にこのタスクを追加すると、アプリのビルド、テスト、発行時にバージョンを使用できるようになります。
ツール インストーラーアプローチを使用すると、エージェントの更新サイクルから切り離すこともできます。 探している .NET Core バージョンが Azure Pipelines エージェント (Hosted または Private) にない場合は、このタスクを使用して、エージェントに適切なバージョンをインストールできます。
必要条件
要件 | 説明 |
---|---|
パイプラインの種類 | YAML、クラシック ビルド、クラシック リリース |
実行日 | エージェント、DeploymentGroup |
確認要求 | なし |
Capabilities | このタスクを実行すると、同じジョブ内の後続のタスクに対して次の 要求 が満たされます: DotNetCore |
コマンドの制限 | Any |
設定可能な変数 | Any |
エージェントのバージョン | 2.144.0 以上 |
タスクのカテゴリ | ツール |
要件 | 説明 |
---|---|
パイプラインの種類 | YAML、クラシック ビルド、クラシック リリース |
実行日 | エージェント、DeploymentGroup |
確認要求 | なし |
Capabilities | このタスクを実行すると、同じジョブ内の後続のタスクに対して次の 要求 が満たされます: DotNetCore |
コマンドの制限 | Any |
設定可能な変数 | Any |
エージェントのバージョン | サポートされているすべてのエージェント バージョン。 |
タスクのカテゴリ | ツール |