DotNetCoreInstaller@1: tarea sdk de .NET Core o instalador en tiempo de ejecución v1

Use esta tarea para adquirir una versión específica del SDK de .NET Core desde Internet o la memoria caché local y agregarla a path.

Importante

Esta tarea está en desuso y se retirará el 31 de enero 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 - Paquete que se va a instalar
string. Obligatorio. Valores permitidos: runtime (solo runtime), sdk (SDK (contiene tiempo de ejecución)). Valor predeterminado: sdk.

Especifica si se va a instalar solo runtime o el SDK completo.

version - Versión
string. Obligatorio. Valor predeterminado: 2.2.x.

Especifica la versión del SDK o el entorno de ejecución de .NET Core que se va a instalar.

Use el siguiente formato para especificar la versión:

• 2.x: instala la versión principal más reciente.
• 2.2.x: instala la versión principal y secundaria más reciente.
• 2.2.104: instala la versión exacta.

Busque el valor de version para instalar SDK/Runtime en el archivo releases-index.

includePreviewVersions - Incluir versiones preliminares
boolean. Valor predeterminado: false.

Especifica si desea que se incluyan versiones preliminares al buscar las versiones más recientes. Esta configuración se omite si especifica una versión exacta, como 3.0.100-preview3-010431.

installationPath - Ruta de acceso para instalar .Net Core
string. Valor predeterminado: $(Agent.ToolsDirectory)/dotnet.

Especifica dónde se debe instalar el SDK o el entorno de ejecución de .NET Core. Las distintas rutas de acceso pueden tener el siguiente impacto en . Comportamiento de NET:

• $(Agent.ToolsDirectory): determina la versión que se almacenará en caché en el agente, ya que este directorio no está limpiado entre canalizaciones. Todas las canalizaciones que se ejecutan en el agente tendrán acceso a las versiones instaladas anteriormente mediante el agente.
• $(Agent.TempDirectory): esto puede asegurarse de que una canalización no usa ninguna versión almacenada en caché de .NET Core, ya que esta carpeta se limpia después de cada canalización.
• Cualquier otra ruta de acceso: puede configurar cualquier otra ruta de acceso, dado que el proceso del agente tiene acceso a la ruta de acceso. Esto cambiará el estado de la máquina y afectará a todos los procesos que se ejecutan en ella.

También puede configurar la opción Búsqueda de varios niveles. Esta configuración puede configurar el host de .NET para que sondee una versión adecuada.

performMultiLevelLookup - Realizar una búsqueda de varios niveles
boolean. Valor predeterminado: false.

Esta entrada solo se aplica a los agentes basados en Windows. Esta entrada configura el comportamiento de los procesos de host de .NET para buscar un marco compartido adecuado. False significa que solo las versiones presentes en la carpeta especificada en esta tarea serían buscadas por el proceso de host. True significa que el host intentará buscar en ubicaciones globales predefinidas mediante búsqueda de varios niveles.

Para Windows, las ubicaciones globales predeterminadas son:

• C:\Program Files\dotnet (procesos de 64 bits)
• C:\Program Files (x86)\dotnet (proceso de 32 bits)

Para más información, consulte Búsqueda SharedFX de varios niveles.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Comentarios

Esta tarea está en desuso. Use @UseDotNet2.

Novedades de esta versión de tarea.

• Compatibilidad con la instalación de varias versiones en paralelo.
• Compatibilidad con patrones en la versión para capturar la versión más reciente en la versión secundaria o principal.
• Restringir la búsqueda de varios niveles.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	La ejecución de esta tarea satisface las siguientes demandas para las tareas posteriores del mismo trabajo: DotNetCore
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	Todas las versiones de agente admitidas.
Categoría de la tarea:	Herramienta