UseDotNet@2 - Use a tarefa dotnet v2

Use esta tarefa para adquirir uma versão específica do SDK do .NET Core da Internet ou do cache local e adicioná-la ao PATH. Use esta tarefa para alterar a versão do .NET Core que é usada em tarefas subsequentes. Esta tarefa também fornece suporte a proxy.

Sintaxe

# 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.

Insumos

packageType - pacote para instalar
string. Valores permitidos: runtime, sdk (SDK (contém tempo de execução)). Valor padrão: sdk.

Especifica se deve ser instalado apenas o tempo de execução do .NET ou o SDK.

useGlobalJson - Use json global
boolean. Opcional. Use quando packageType = sdk. Valor padrão: false.

Instala todos os SDKs a partir de arquivos global.json. Esses arquivos são pesquisados a partir de system.DefaultWorkingDirectory. Você pode alterar o caminho da raiz de pesquisa definindo a entrada do diretório de trabalho.

O formato 6.x e 6.1.x (usando .x como curinga) descrito na entrada UseDotNet@2.version é para uso na entrada version na tarefa, não o parâmetro sdk.version 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 seu global.json.

Para obter mais informações sobre global.json, consulte Selecione a versão .NET a ser usada.

workingDirectory - Diretório de Trabalho
string. Opcional. Use quando useGlobalJson = true.

Especifica o caminho de onde global.json arquivos devem ser pesquisados ao usar useGlobalJson. Se o valor estiver vazio, system.DefaultWorkingDirectory será considerado como o caminho raiz.

version - Versão
string. Opcional. Use quando useGlobalJson = false || packageType = runtime.

Especifica a versão do SDK do .NET Core ou do tempo de execução a ser instalado. Os formatos de valor de versão são mostrados com exemplos:

• 2.x: Instala o SDK ou tempo de execução mais recente com a versão principal especificada, 2.
• 3.1.x: Instala o SDK ou tempo de execução mais recente com as versões principais e secundárias especificadas, 3 e 1.
• 3.1.402: Instala o SDK especificado ou a versão de tempo de execução, 3.1.402.

Os valores de versão para instalações SDK ou runtime estão no arquivo releases.json. O link para o de uma versão principal/secundária está no arquivo de índice de lançamentos . Por exemplo, o link para o arquivo 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 correspondente do SDK do .NET Core. O valor deve 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 SDK ou runtime, que são usados para a cadeia de caracteres version, estão no arquivo releases.json. O link para o de uma versão principal/secundária está no arquivo de índice de lançamentos . Por exemplo, o link para o arquivo releases.json para a versão 3.1.

includePreviewVersions - Incluir versões de visualização
boolean. Opcional. Use quando useGlobalJson = false || packageType = runtime. Valor padrão: false.

Se definido como true, inclui versões de visualização quando a tarefa procura as versões mais recentes do tempo de execução/SDK, como procurar 2.2.x ou 3.1.x. Essa configuração será ignorada se você especificar uma versão exata, como 3.0.100-preview3-010431.

installationPath - caminho para instalar o .Net Core
string. Valor padrão: $(Agent.ToolsDirectory)/dotnet.

Especifica onde o .NET Core SDK/Runtime deve ser instalado. Caminhos diferentes podem ter o seguinte impacto no . Comportamento da NET.

• $(Agent.ToolsDirectory): O uso desse caminho armazena em cache a instalação no agente, pois esse diretório não é limpo entre pipelines. Todos os pipelines em execução no agente têm acesso às versões instaladas anteriormente.
• $(Agent.TempDirectory): O uso desse caminho garante que um pipeline não use uma versão em cache do .NET Core, pois essa pasta é limpa após cada pipeline.
• Outro caminho: Você pode usar qualquer caminho se o processo do agente tiver acesso ao caminho. Isso mudará o estado da máquina e afetará todos os processos em execução nela.

Observação

Você pode usar a configuração Pesquisa de Vários Níveis, performMultiLevelLookup, para configurar como o host .NET procura versões.

performMultiLevelLookup - Executar pesquisa de vários níveis
boolean. Valor padrão: false.

Configura o comportamento do processo de host .NET quando ele procura uma estrutura compartilhada adequada. Os valores são:

• false: O processo de host procura apenas versões que estão presentes na pasta especificada pela tarefa.
• true: O processo de host pesquisará em locais globais predefinidos usando pesquisa de vários níveis. Os locais globais padrão são:
  • C:\Program Files\dotnet (processos de 64 bits)
  • C:\Program Files (x86)\dotnet (processos de 32 bits)

Saiba mais sobre pesquisa SharedFX de vários níveis.

Observação

performMultiLevelLookup só é aplicável a agentes baseados no Windows.

requestTimeout - Definir tempo limite para solicitação de download de pacote
string. Valor padrão: 300000.

Forneça um valor de tempo limite para solicitações HTTP que a tarefa faz para obter o pacote .NET. O valor é em milissegundos. O padrão é 300000 milissegundos (5 minutos). Não pode ser superior a 600000 milissegundos (10 minutos).

Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhuma.

Comentários

A tarefa Usar .NET Core adquire uma versão específica do .NET Core da Internet ou do cache de ferramentas e a adiciona ao PATH do Agente de Pipelines do Azure (hospedado ou privado). Use esta tarefa para alterar a versão do .NET Core usada em tarefas subsequentes, como DotNetCoreCLI@2. Adicionar essa tarefa antes do DotNetCoreCLI@2 em uma definição de compilação garante que a versão esteja disponível no momento da criação, teste e publicação do seu aplicativo.

A abordagem do instalador de ferramentas também permite que você se desacople dos ciclos de atualização do agente. Se a versão do .NET Core que você está procurando estiver faltando no agente do Azure Pipelines (Hospedado ou Privado), então você pode usar essa tarefa para obter a versão correta instalada no agente.

Requerimentos

Exigência	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Nenhum
Capacidades	A execução desta tarefa satisfaz as seguintes exigências para quaisquer tarefas subsequentes no mesmo trabalho: DotNetCore
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	2.144.0 ou superior
Categoria de tarefa	Ferramenta