Uso de la tarea de .NET Core

  • Artículo
  • 3 minutos para leer
ParámetrosDescripción
packageType
Paquete que se instalará		Seleccione si desea instalar solo el entorno de ejecución o el SDK.
Valor predeterminado: sdk
useGlobalJson
Uso de json global		Seleccione esta opción para instalar todos los SDK desde archivos global.json. Estos archivos se buscan desde el sistema. DefaultWorkingDirectory. Puede cambiar la ruta de acceso raíz de búsqueda estableciendo la entrada del directorio de trabajo.
workingDirectory
Directorio de trabajo		Especifique la ruta de acceso desde la que se deben buscar los archivos global.json al usar "Usar json global". Si está vacío, system. DefaultWorkingDirectory se considerará como la ruta de acceso raíz
version
Version		Especifique la versión de SDK de .NET Core o runtime que se instalará.
Las versiones se pueden dar en los formatos siguientes
  • 2.x = > Instalar la versión más reciente en la versión principal.
  • 3.1.x = > Instalación más reciente en la versión principal y secundaria
  • 3.1.402 = > Instalación de la versión exacta

    • Busque el valor de version para instalar SDK/Runtime en releases.json. El vínculo a releases.json de esa versión principal.secundaria se puede encontrar en el archivo releases-index.. Al igual que el vínculo a releases.json para la versión 3.1 es https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/3.1/releases.json
    includePreviewVersions
    Incluir versiones preliminares    		Seleccione si desea que las versiones preliminares se incluyan al buscar las versiones más recientes, como al buscar la versión 3.1.x. Esta configuración se omite si especifica una versión exacta, como: 3.0.100-preview3-010431
    Valor predeterminado: false
    installationPath
    Ruta de acceso para instalar .NET Core    		Especifique dónde SDK de .NET Core/Runtime deben instalarse. Las distintas rutas de acceso pueden tener el siguiente impacto en . Comportamiento de NET.
  • $(Agent.ToolsDirectory): hace que la versión se almacene en caché en el agente, ya que este directorio no se limpia entre canalizaciones. Todas las canalizaciones que se ejecutan en el agente tendrían acceso a las versiones instaladas anteriormente mediante el agente.
  • $(Agent.TempDirectory): esto puede garantizar que una canalización no use 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.
    Tenga en cuenta que también puede configurar la opción Búsqueda de varios niveles, que puede configurar el sondeo del host de .NET para una versión adecuada.
    Valor predeterminado: $(Agent.ToolsDirectory)/dotnet
    • performMultiLevelLookup
    Realizar búsquedas de varios niveles    		Esta entrada solo es aplicable a los Windows basados en datos. Esto configura el comportamiento del proceso de host de .NET para buscar un marco compartido adecuado.
  • false: (valor predeterminado) El proceso de host buscaría solo las versiones presentes en la carpeta especificada en esta tarea.
  • true: el host intentará buscar en ubicaciones globales predefinidas mediante la búsqueda de varios niveles.
    Las ubicaciones globales predeterminadas son:
    Para Windows:
    C:/Archivos de programa/dotnet (procesos de 64 bits)
    C:/Archivos de programa (x86)/dotnet (proceso de 32 bits)
    • Puede leer más al respecto AQUÍ.

    En este ejemplo de YAML se instala la versión 3.1.402 de .NET Core.

    steps:
- task: UseDotNet@2
  displayName: 'Use .NET Core sdk'
  inputs:
    packageType: sdk
    version: 3.1.402
    installationPath: $(Agent.ToolsDirectory)/dotnet

    Código Abierto

    Esta tarea es de código abierto en GitHub. Los comentarios y las contribuciones son bienvenidos.

    Azure Pipelines

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

    También puede usar esta tarea para cambiar la versión de .NET Core que se usa en tareas posteriores, como la tarea de la CLI de .NET Core.

    Otra razón para usar el instalador de herramientas es si desea desacoplar la canalización de nuestros ciclos de actualización para ayudar a evitar que se rompa una ejecución de canalización debido a un cambio que se realiza en el software del agente.

    What's New

    • Compatibilidad con la instalación de varias versiones en paralelo.

    • Compatibilidad con patrones en versión para capturar la versión más reciente en la versión secundaria o principal. Por ejemplo, ahora puede especificar 3.1.x para obtener la revisión más reciente.

    • Realizar búsquedas de varios niveles. Esta entrada solo es aplicable a los Windows basados en datos. Configura el comportamiento del proceso de host de .NET Core para buscar un marco compartido adecuado en la máquina. Para obtener más información, vea Búsqueda de SharedFX de varios niveles.

    • Instala NuGet versión 4.4.1 y configura la configuración del proxy si está presente en NuGet configuración.

    Entradas de tareas