UseDotNet@2 - Utilizar a tarefa dotnet v2
Utilize esta tarefa para adquirir uma versão específica do SDK .NET Core a partir da Internet ou da cache local e adicioná-la ao PATH. Utilize esta tarefa para alterar a versão do .NET Core que é utilizada em tarefas subsequentes. Esta tarefa também fornece suporte de proxy.
Syntax
# 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.
Entradas
packageType
- Pacote a instalar
string
. Valores permitidos: runtime
, sdk
(SDK (contém runtime)). Valor predefinido: sdk
.
Especifica se pretende instalar apenas o runtime do .NET ou o SDK.
useGlobalJson
- Utilizar json global
boolean
. Opcional. Utilize quando packageType = sdk
. Valor predefinido: false
.
Instala todos os SDKs a partir de global.json
ficheiros. Estes ficheiros são pesquisados a partir de system.DefaultWorkingDirectory
. Pode alterar o caminho de raiz de pesquisa ao definir a entrada do diretório de trabalho.
O 6.x
formato e 6.1.x
(utilizando .x
como caráter universal) descrito na UseDotNet@2.version
entrada é para utilização na version
entrada na tarefa e não no sdk.version
parâmetro em global.json
.
Se receber uma mensagem de erro como ##[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.
e estiver a utilizar global.json
, verifique o sdk.version
no .global.json
Para obter mais informações sobre global.json
o , consulte Selecionar a versão do .NET a utilizar.
workingDirectory
- Diretório de Trabalho
string
. Opcional. Utilize quando useGlobalJson = true
.
Especifica o caminho a partir do global.json
qual os ficheiros devem ser pesquisados ao utilizar useGlobalJson
. Se o valor estiver vazio, system.DefaultWorkingDirectory
será considerado como o caminho raiz.
version
- Versão
string
. Opcional. Utilize quando useGlobalJson = false || packageType = runtime
.
Especifica a versão do SDK do .NET Core ou do runtime a instalar. Os formatos de valor da versão são apresentados com exemplos:
2.x
: instala o SDK ou runtime mais recente com a versão principal especificada,2
.3.1.x
: instala o SDK ou runtime mais recente com as versões principais e secundárias especificadas e3
1
.3.1.402
: instala o SDK especificado ou a versão de runtime,3.1.402
.
Os valores de versão das instalações do SDK ou do runtime estão no releases.json
ficheiro. A ligação para a releases.json
de uma versão principal/secundária está no ficheiro releases-index . Por exemplo, a ligação para o ficheiro releases.json para a versão 3.1.
version
- Versão
string
.
Especifica a versão do SDK do .NET Core ou do runtime a instalar. Os formatos de valor da versão são apresentados com exemplos:
2.x
: instala o SDK ou runtime mais recente com a versão principal especificada,2
.3.1.x
: instala o SDK ou runtime mais recente com as versões principais e secundárias especificadas e3
1
.3.1.402
: instala o SDK especificado ou a versão de runtime,3.1.402
.
Os valores de versão das instalações do SDK ou do runtime estão no releases.json
ficheiro. A ligação para a releases.json
de uma versão principal/secundária está no ficheiro releases-index . Por exemplo, a ligação para o ficheiro releases.json para a versão 3.1.
vsVersion
- Versão compatível do Visual Studio
string
.
Especifica uma versão compatível do Visual Studio para uma instalação do SDK .NET Core correspondente. O valor tem de ser um número de versão completo, como 16.6.4
, que contém uma versão principal, uma versão secundária e um número de patch.
Os valores de versão para instalações de SDK ou runtime, que são utilizados para a version
cadeia, estão no releases.json
ficheiro. A ligação para a releases.json
de uma versão principal/secundária está no ficheiro releases-index . Por exemplo, a ligação para o ficheiro releases.json para a versão 3.1.
includePreviewVersions
- Incluir Versões de Pré-visualização
boolean
. Opcional. Utilize quando useGlobalJson = false || packageType = runtime
. Valor predefinido: false
.
Se estiver definido como true
, inclui versões de pré-visualização quando a tarefa procura versões mais recentes do runtime/SDK, como procurar 2.2.x
ou 3.1.x
. Esta definição é ignorada se especificar uma versão exata, como 3.0.100-preview3-010431
.
includePreviewVersions
- Incluir Versões de Pré-visualização
boolean
. Valor predefinido: false
.
Se estiver definido como true
, inclui versões de pré-visualização quando a tarefa procura versões mais recentes do runtime/SDK, como procurar 2.2.x
ou 3.1.x
. Esta definição é ignorada se especificar uma versão exata, como 3.0.100-preview3-010431
.
installationPath
- Caminho para Instalar o .Net Core
string
. Valor predefinido: $(Agent.ToolsDirectory)/dotnet
.
Especifica onde o SDK/Runtime do .NET Core deve ser instalado. Caminhos diferentes podem ter o seguinte impacto em . O comportamento do NET.
$(Agent.ToolsDirectory)
: a utilização deste caminho coloca em cache a instalação no agente, uma vez que este diretório não é limpo em pipelines. Todos os pipelines em execução no agente têm acesso às versões instaladas anteriormente.$(Agent.TempDirectory)
: a utilização deste caminho garante que um pipeline não utiliza uma versão em cache do .NET Core, uma vez que esta pasta é limpa após cada pipeline.- Outro caminho: pode utilizar qualquer caminho se o processo do agente tiver acesso ao caminho. Isto irá alterar o estado do computador e afetar todos os processos em execução no mesmo.
Nota
Pode utilizar a definição Pesquisa de Vários Níveis , performMultiLevelLookup
, para configurar a forma como o anfitrião .NET procura versões.
performMultiLevelLookup
- Efetuar Pesquisa de Vários Níveis
boolean
. Valor predefinido: false
.
Configura o comportamento do processo de anfitrião .NET quando procura uma arquitetura partilhada adequada. Os valores são:
false
: o processo de anfitrião procura apenas as versões que estão presentes na pasta especificada pela tarefa.true
: o processo de anfitrião irá procurar em localizações globais predefinidas através da pesquisa de vários níveis. As localizações globais predefinidas são:C:\Program Files\dotnet
(processos de 64 bits)C:\Program Files (x86)\dotnet
(processos de 32 bits)
Saiba mais sobre a pesquisa sharedFX de vários níveis.
Nota
performMultiLevelLookup
só é aplicável a agentes baseados no Windows.
Opções de controlo de tarefas
Todas as tarefas têm opções de controlo para além das respetivas entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Observações
A tarefa Utilizar .NET Core adquire uma versão específica do .NET Core a partir da Internet ou da cache de ferramentas e adiciona-a ao CAMINHO do Agente dos Pipelines do Azure (alojado ou privado). Utilize esta tarefa para alterar a versão do .NET Core utilizada em tarefas subsequentes, como DotNetCoreCLI@2. Adicionar esta tarefa antes do DotNetCoreCLI@2 numa definição de compilação garante que a versão estaria disponível no momento da criação, teste e publicação da sua aplicação.
A abordagem do instalador de ferramentas também lhe permite desassociar dos ciclos de atualização do agente. Se a versão do .NET Core que procura estiver em falta no agente dos Pipelines do Azure (Alojado ou Privado), pode utilizar esta tarefa para instalar a versão certa no agente.
Requisitos
Requisito | Description |
---|---|
Tipos de pipeline | YAML, Compilação clássica, Versão clássica |
É executado em | Agente, DeploymentGroup |
Exigências | Nenhuma |
Capacidades | Executar esta tarefa satisfaz as seguintes exigências para quaisquer tarefas subsequentes no mesmo trabalho: DotNetCore |
Restrições de comandos | Qualquer |
Variáveis de tabelas definidas | Qualquer |
Versão do agente | 2.144.0 ou superior |
Categoria da tarefa | Ferramenta |
Requisito | Description |
---|---|
Tipos de pipeline | YAML, Compilação clássica, Versão clássica |
É executado em | Agente, DeploymentGroup |
Exigências | Nenhuma |
Capacidades | Executar esta tarefa satisfaz as seguintes exigências para quaisquer tarefas subsequentes no mesmo trabalho: DotNetCore |
Restrições de comandos | Qualquer |
Variáveis de tabelas definidas | Qualquer |
Versão do agente | Todas as versões de agente suportadas. |
Categoria da tarefa | Ferramenta |