DotNetCoreInstaller@1 – Tarefa do instalador v1 do SDK/runtime do .NET Core

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.

Importante

Essa tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use UseDotNet@2.

Syntax

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #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 ser instalado
string. Obrigatórios. Valores permitidos: runtime (Somente Runtime), sdk (SDK (contém runtime)). Valor padrão: sdk.

Especifica se é necessário instalar somente o Runtime ou o SDK completo.

version - Versão
string. Obrigatórios. Valor padrão: 2.2.x.

Especifica a versão do SDK ou runtime do .NET Core a ser instalada.

Use o seguinte formato para especificar a versão:

• 2.x: instala o mais recente na versão principal.
• 2.2.x: instala o mais recente na versão principal e secundária.
• 2.2.104: instala a versão exata.

Localize o valor de version para instalar o SDK/Runtime no arquivo releases-index.

includePreviewVersions - Incluir versões prévias
boolean. Valor padrão: false.

Especifica se você deseja que as versões prévias sejam incluídas durante a pesquisa de versões mais recentes. Essa configuração será ignorada se você especificar uma versão exata, como 3.0.100-preview3-010431.

installationPath - Caminho para instalar .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): determina a versão a ser armazenada em cache no agente, pois esse diretório não é limpo em pipelines. Todos os pipelines em execução no agente teriam acesso às versões instaladas anteriormente usando o agente.
• $(Agent.TempDirectory): isso pode garantir que um pipeline não use nenhuma versão armazenada em cache do .NET Core, pois essa pasta é limpa após cada pipeline.
• Qualquer outro caminho: você pode configurar qualquer outro caminho, dado que o processo do agente tem acesso ao caminho. Isso alterará o estado do computador e afetará todos os processos em execução nele.

Você também pode definir a configuração pesquisa de vários níveis. Essa configuração pode configurar o host .NET para investigar uma versão adequada.

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

Essa entrada só é aplicável a agentes baseados no Windows. Essa entrada configura o comportamento dos processos de host do .NET para procurar uma estrutura compartilhada adequada. False significa que somente as versões presentes na pasta especificada nesta tarefa seriam analisadas pelo processo de host. True significa que o host tentará procurar locais globais predefinidos usando a Pesquisa de Vários Níveis.

Para o Windows, os locais globais padrão são:

• C:\Program Files\dotnet (Processos de 64 bits)
• C:\Program Files (x86)\dotnet (Processo de 32 bits)

Para obter mais informações, confira Pesquisa do SharedFX em vários níveis.

Opções de controle da tarefa

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

Variáveis de saída

Nenhum.

Comentários

Essa tarefa foi preterida. Use @UseDotNet2.

Novidades nesta versão da tarefa.

• Suporte para instalar várias versões lado a lado.
• Suporte para padrões na versão para buscar o mais recente na versão secundária/principal.
• Restringir a pesquisa de vários níveis.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Executa em	Agent, DeploymentGroup
Demandas	Nenhum
Funcionalidades	A execução dessa tarefa atende às seguintes demandas para todas as tarefas subsequentes no mesmo trabalho: DotNetCore
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	Todas as versões do agente com suporte.
Categoria da tarefa	Ferramenta