UseDotNet@2 – Usar a tarefa dotnet v2

Use essa 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 essa tarefa para alterar a versão do .NET Core que é usada em tarefas subsequentes. Essa 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.

Entradas

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

Especifica se o runtime do .NET ou o SDK deve ser instalado.

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

Instala todos os SDKs de global.json arquivos. Esses arquivos são pesquisados de system.DefaultWorkingDirectory. Você pode alterar o caminho raiz da 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 é usado na entrada version na tarefa, não no parâmetro sdk.version no global.json.

Se você 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 usando global.json, verifique o sdk.version em seu global.json.

Para obter mais informações sobre global.json, consulte Selecione a versão do .NET para usar.

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

Especifica o caminho de onde os arquivos global.json 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 ou runtime do .NET Core a ser instalada. Os formatos de valor de versão são mostrados 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, 3 e 1.
• 3.1.402: instala o SDK ou a versão de runtime especificada, 3.1.402.

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

includePreviewVersions - incluir versões prévias
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 pesquisa versões mais recentes do runtime/SDK, como pesquisar 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 SDK/Runtime do .NET Core deve ser instalado. Caminhos diferentes podem ter o seguinte impacto em . Comportamento do NET.

• $(Agent.ToolsDirectory): o uso desse caminho armazena em cache a instalação no agente, pois esse 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): usar esse caminho garante que um pipeline não use uma versão armazenada em cache do .NET Core, pois essa pasta é limpa após cada pipeline.
• Outro caminho: você poderá usar qualquer caminho se o processo do agente tiver acesso ao caminho. Isso alterará o estado do computador e afetará todos os processos em execução nele.

Nota

Você pode usar a configuração pesquisa de vários níveis , , para configurar como o host do .NET pesquisa versões.

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

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

• false: o processo de host pesquisa apenas as versões 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 de pesquisa SharedFX de vários níveis.

Nota

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

requestTimeout - Definir tempo limite para de solicitação de download do 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 está em milissegundos. O padrão é 300000 milissegundos (5 minutos). Não pode ser mais de 600000 milissegundos (10 minutos).

Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Observações

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 build garante que a versão esteja disponível no momento da criação, teste e publicação do aplicativo.

A abordagem do instalador de ferramentas também permite que você se desvincula dos ciclos de atualização do agente. Se a versão do .NET Core que você está procurando estiver ausente do agente do Azure Pipelines (hospedado ou privado), você poderá usar essa tarefa para obter a versão certa instalada no agente.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
recursos	Executar essa tarefa atende às seguintes demandas de para quaisquer tarefas subsequentes no mesmo trabalho: DotNetCore
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	2.144.0 ou superior
Categoria de tarefa	Ferramenta