UseDotNet@2: uso de la tarea dotnet v2

Use esta tarea para adquirir una versión específica del SDK de .NET Core desde Internet o la caché local y agregarla a path. Use esta tarea para cambiar la versión de .NET Core que se usa en tareas posteriores. Esta tarea también proporciona compatibilidad con proxy.

Sintaxis

# 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

packageType - Paquete para instalar
string. Valores permitidos: runtime, sdk (SDK (contiene tiempo de ejecución). Valor predeterminado: sdk.

Especifica si se va a instalar solo el entorno de ejecución de .NET o el SDK.

useGlobalJson - Uso de json global
boolean. Opcional. Use cuando packageType = sdk. Valor predeterminado: false.

Instala todos los SDK desde global.json archivos. Estos archivos se buscan desde system.DefaultWorkingDirectory. Puede cambiar la ruta de acceso raíz de búsqueda estableciendo la entrada del directorio de trabajo.

El formato 6.x y 6.1.x (con .x como carácter comodín) descrito en la entrada UseDotNet@2.version se usa en la entrada version de la tarea, no en el parámetro sdk.version de global.json.

Si recibe un mensaje de error 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. y usa global.json, compruebe el sdk.version en el global.json.

Para obtener más información sobre global.json, vea Seleccione la versión de .NET para usar.

de directorio de trabajo de
string. Opcional. Use cuando useGlobalJson = true.

Especifica la ruta de acceso desde donde se deben buscar global.json archivos al usar useGlobalJson. Si el valor está vacío, system.DefaultWorkingDirectory se considerará como la ruta de acceso raíz.

version - versión
string. Opcional. Use cuando useGlobalJson = false || packageType = runtime.

Especifica la versión del SDK o el entorno de ejecución de .NET Core que se va a instalar. Los formatos de valor de versión se muestran con ejemplos:

• 2.x: instala el SDK o el entorno de ejecución más recientes con la versión principal especificada, 2.
• 3.1.x: instala el SDK o el entorno de ejecución más recientes con las versiones principales y secundarias especificadas, 3 y 1.
• 3.1.402: instala el SDK o la versión del entorno de ejecución especificados, 3.1.402.

Los valores de versión de las instalaciones del SDK o del entorno de ejecución se encuentran en el archivo releases.json. El vínculo a la de una versión principal o secundaria se encuentra en el archivo releases-index. Por ejemplo, el vínculo al archivo releases.json de la versión 3.1.

vsVersion - versión compatible de Visual Studio
string.

Especifica una versión compatible de Visual Studio para una instalación correspondiente del SDK de .NET Core. El valor debe ser un número de versión completo, como 16.6.4, que contiene una versión principal, una versión secundaria y un número de revisión.

Los valores de versión de las instalaciones del SDK o del entorno de ejecución, que se usan para la cadena de version, se encuentran en el archivo releases.json. El vínculo a la de una versión principal o secundaria se encuentra en el archivo releases-index. Por ejemplo, el vínculo al archivo releases.json de la versión 3.1.

includePreviewVersions - incluir versiones preliminares
boolean. Opcional. Use cuando useGlobalJson = false || packageType = runtime. Valor predeterminado: false.

Si se establece en true, incluye versiones preliminares cuando la tarea busca versiones más recientes del entorno de ejecución o del SDK, como buscar 2.2.x o 3.1.x. Esta configuración se omite si especifica una versión exacta, como 3.0.100-preview3-010431.

installationPath - ruta de acceso para instalar de .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 diferentes rutas de acceso pueden tener el siguiente impacto en . Comportamiento de NET.

• $(Agent.ToolsDirectory): el uso de esta ruta de acceso almacena en caché la instalación en el agente, ya que este directorio no se limpia entre canalizaciones. Todas las canalizaciones que se ejecutan en el agente tienen acceso a las versiones instaladas anteriormente.
• $(Agent.TempDirectory): el uso de esta ruta de acceso garantiza que una canalización no use una versión almacenada en caché de .NET Core, ya que esta carpeta se limpia después de cada canalización.
• Otra ruta de acceso: puede usar cualquier ruta de acceso si 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.

Nota

Puede usar la configuración búsqueda de varios niveles , , para configurar cómo busca versiones el host de .NET.

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

Configura el comportamiento del proceso de host de .NET cuando busca un marco compartido adecuado. Los valores son:

• false: el proceso de host solo busca versiones presentes en la carpeta especificada por la tarea.
• true: el proceso de host buscará en ubicaciones globales predefinidas mediante la búsqueda de varios niveles. Las ubicaciones globales predeterminadas son:
  • C:\Program Files\dotnet (procesos de 64 bits)
  • C:\Program Files (x86)\dotnet (procesos de 32 bits)

Obtenga más información sobre búsqueda de SharedFX de varios niveles.

Nota

performMultiLevelLookup solo es aplicable a los agentes basados en Windows.

requestTimeout - Establecer el tiempo de espera de la solicitud de descarga de paquetes
string. Valor predeterminado: 300000.

Proporcione un valor de tiempo de espera para las solicitudes HTTP que realiza la tarea para obtener el paquete de .NET. El valor está en milisegundos. El valor predeterminado es 300000 milisegundos (5 minutos). No puede tener más de 600000 milisegundos (10 minutos).

Opciones de control de tareas

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

Variables de salida

Ninguno.

Observaciones

La tarea Usar .NET Core adquiere una versión específica de .NET Core desde Internet o la memoria caché de herramientas y la agrega a la RUTA de acceso del agente de Azure Pipelines (hospedado o privado). Use esta tarea para cambiar la versión de .NET Core que se usa en tareas posteriores como DotNetCoreCLI@2. Agregar esta tarea antes del DotNetCoreCLI@2 en una definición de compilación garantiza que la versión estaría disponible en el momento de compilar, probar y publicar la aplicación.

El enfoque del instalador de herramientas también permite desacoplar los ciclos de actualización del agente. Si falta la versión de .NET Core que busca en el agente de Azure Pipelines (hospedado o privado), puede usar esta tarea para obtener la versión correcta instalada en el agente.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Ninguno
funcionalidades de	La ejecución de esta tarea satisface las siguientes exige para las tareas posteriores del mismo trabajo: DotNetCore
restricciones de comandos	Cualquier
variables settable	Cualquier
Versión del agente	2.144.0 o superior
Categoría de tarea	Herramienta