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 memoria caché local y agregarla a path. Use esta tarea para cambiar la versión de .NET Core que se usa en las 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.
  # 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 que se va a 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 de global.json los 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 6.x formato y 6.1.x (que se usa .x como carácter comodín) descrito en la UseDotNet@2.version entrada es para su uso en la version entrada de la tarea, no en el sdk.version parámetro 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 en sdk.versionglobal.json.

Para obtener más información sobre global.json, consulte Selección de la versión de .NET que se va a usar.

workingDirectory - Directorio de trabajo
string. Opcional. Use cuando useGlobalJson = true.

Especifica la ruta de acceso desde donde global.json se deben buscar los 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 del SDK o las instalaciones en tiempo de ejecución se encuentran en el releases.json archivo . El vínculo a de releases.json una versión principal o secundaria está 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 para las instalaciones de SDK o en tiempo de ejecución, que se usan para la version cadena, se encuentran en el releases.json archivo . El vínculo a de releases.json una versión principal o secundaria está 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 las versiones más recientes del entorno de ejecución o el 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 .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): 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 opción Búsqueda de varios niveles, performMultiLevelLookup, para configurar cómo el host de .NET busca versiones.

performMultiLevelLookup - Realizar una 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 busca solo las versiones que están 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 la búsqueda sharedFX de varios niveles.

Nota

performMultiLevelLookup solo es aplicable a los agentes basados en Windows.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tareas. Para obtener más información, vea 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á 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
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	2.144.0 o superior
Categoría de la tarea:	Herramienta