DotNetCoreInstaller@1 – Tarefa de instalação do SDK/runtime do .NET Core v1

Artigo
07/02/2024

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.

Importante

Esta tarefa foi preterida e será descontinuada a 31 de janeiro de 2024. Utilize UseDotNet@2.

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.

Importante

Esta tarefa foi preterida. Utilize @UseDotNet2.

Adquire uma versão específica do SDK .NET Core a partir da Internet ou da cache local e adiciona-a ao PATH.

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 instalar
string. Obrigatório. Valores permitidos: runtime (Apenas Runtime), sdk (SDK (contém runtime)). Valor predefinido: sdk.

Especifica se pretende instalar apenas o Runtime ou o SDK completo.

version - Versão
string. Obrigatório. Valor predefinido: 2.2.x.

Especifica a versão do SDK do .NET Core ou do Runtime a instalar.

Utilize o seguinte formato para especificar a versão:

2.x: instala a versão mais recente na versão principal.
2.2.x: instala a versã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 ficheiro releases-index.

includePreviewVersions - Incluir Versões de Pré-visualização
boolean. Valor predefinido: false.

Especifica se pretende que as versões de pré-visualização sejam incluídas enquanto procura as versões mais recentes. 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. Diferentes caminhos podem ter o seguinte impacto em . Comportamento do NET:

$(Agent.ToolsDirectory): isto determina a versão a ser colocada em cache no agente, uma vez que este diretório não é limpo em pipelines. Todos os pipelines em execução no agente teriam acesso às versões instaladas anteriormente com o agente.
$(Agent.TempDirectory): isto pode garantir que um pipeline não utiliza nenhuma versão em cache do .NET Core, uma vez que esta pasta é limpa após cada pipeline.
Qualquer outro caminho: pode configurar qualquer outro caminho, dado que o processo do agente tem acesso ao caminho. Isto irá alterar o estado da máquina e afetar todos os processos em execução no mesmo.

Também pode configurar a definição Pesquisa de Vários Níveis. Esta definição pode configurar o anfitrião .NET para sondar uma versão adequada.

performMultiLevelLookup - Realizar Pesquisa de Vários Níveis
boolean. Valor predefinido: false.

Esta entrada só é aplicável a agentes baseados no Windows. Esta entrada configura o comportamento dos processos de anfitrião .NET para procurar uma arquitetura partilhada adequada. False significa que apenas as versões presentes na pasta especificada nesta tarefa seriam consultadas pelo processo de anfitrião. True significa que o anfitrião tentará procurar em localizações globais predefinidas através da Pesquisa de Vários Níveis.

Para o Windows, as localizações globais predefinidas são:

C:\Program Files\dotnet (processos de 64 bits)
C:\Program Files (x86)\dotnet (processo de 32 bits)

Para obter mais informações, veja Pesquisa sharedFX de vários níveis.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das 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

Esta tarefa foi preterida. Utilize @UseDotNet2.

Novidades nesta versão de tarefa.

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

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	Todas as versões de agente suportadas.
Categoria da tarefa	Ferramenta

Partilhar via