Compilación, prueba e implementación de aplicaciones de .NET Core

Inicio de sesión en Azure Pipelines

Inicie sesión en Azure Pipelines. Una vez que haya iniciado sesión, el explorador accederá a https://dev.azure.com/my-organization-name y aparecerá el panel de Azure DevOps.

En la organización seleccionada, cree un proyecto. Si no tiene ningún proyecto en la organización, aparecerá la pantalla Cree un proyecto para empezar. De lo contrario, seleccione el botón Crear proyecto en la esquina superior derecha del panel.

1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

2. Vaya a Pipelinesy, a continuación, seleccione Nueva canalización.

3. Siga los pasos del asistente y seleccione primero GitHub como ubicación del código fuente.

4. Puede que se le redirija a GitHub para iniciar sesión. Si es así, escriba sus credenciales de GitHub.

5. Cuando aparezca la lista de repositorios, seleccione el que corresponda.

6. Es posible que se le redirija a GitHub para instalar la aplicación Azure Pipelines. Si es así, seleccione Aprobar instalación.

Cuando aparezca la pestaña Configurar, seleccione ASP.NET Core.

1. Cuando aparezca la nueva canalización, echa un vistazo a YAML para ver lo que hace. Cuando esté listo, seleccione Guardar y ejecute.

   

2. Se le pedirá que confirme un nuevo archivo azure-pipelines.yml en el repositorio. Una vez satisfecho con el mensaje, seleccione Guardar y ejecutar de nuevo.

   Si desea ver la canalización en acción, seleccione el trabajo de compilación.

   Acaba de crear y ejecutó una canalización que creamos automáticamente, porque el código parece ser una buena coincidencia para la plantilla ASP.NET Core datos.

   Ahora tiene una canalización YAML en funcionamiento ( ) en el repositorio que azure-pipelines.yml está lista para personalizar.

3. Cuando esté listo para realizar cambios en la canalización, selecciónelo en la Pipelines y, a continuación, edite el archivo.

4. Consulte las secciones siguientes para obtener información sobre algunas de las formas más comunes de personalizar la canalización.

YAML

1. Agregue un azure-pipelines.yml archivo en el repositorio. Personalice este fragmento de código para la compilación.

trigger:
- master

pool: Default

variables:
  buildConfiguration: 'Release'

# do this before all your .NET Core tasks
steps:
- task: DotNetCoreInstaller@2
  inputs:
    version: '2.2.402' # replace this value with the version that you need for your project
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'

2. Cree una canalización (si no sabe cómo, consulte Creación de la primera canalización)y, para la plantilla, seleccione YAML.

3. Establezca el grupo de agentes y la ruta de acceso del archivo YAML para la canalización.

4. Guarde la canalización y poner en cola una compilación. Cuando aparezca el mensaje Build #nnnnnnnn.n se ha puesto en cola, seleccione el vínculo number para ver la canalización en acción.

5. Cuando esté listo para realizar cambios en la canalización, edite la canalización.

6. Consulte las secciones siguientes para obtener información sobre algunas de las formas más comunes de personalizar la canalización.

Clásico

1. Cree una canalización (si no sabe cómo, consulte Creación de la primera canalización). Seleccione Canalización vacía para la plantilla.

2. En el catálogo de tareas, busque y agregue la tarea .NET Core. Esta tarea se ejecutará dotnet build para compilar el código en el repositorio de ejemplo.

3. Guarde la canalización y poner en cola una compilación. Cuando aparezca el mensaje Build #nnnnnnnn.n se ha puesto en cola, seleccione el vínculo number para ver la canalización en acción.

   Ahora tiene una canalización de trabajo que está lista para personalizar.

4. Cuando esté listo para realizar cambios en la canalización, edite la canalización.

5. Consulte las secciones siguientes para obtener información sobre algunas de las formas más comunes de personalizar la canalización.

Use Azure Pipelines para compilar proyectos de .NET Core en Windows, Linux o macOS sin necesidad de configurar ninguna infraestructura propia. Los agentes hospedados por Microsoft en Azure Pipelines incluyen varias versiones publicadas de los SDK de .NET Core preinstalados.

Ubuntu 18.04 se establece aquí en el archivo YAML.

pool:
  vmImage: 'ubuntu-18.04' # examples of other options: 'macOS-10.15', 'windows-2019'

Consulte Agentes hospedados por Microsoft para obtener una lista completa de imágenes y Grupo para obtener más ejemplos.

Los agentes hospedados por Microsoft no incluyen algunas de las versiones anteriores del SDK de .NET Core. Tampoco suelen incluir versiones preliminares. Si necesita estos tipos de SDK en agentes hospedados por Microsoft, agregue la UseDotNet@2 al archivo YAML.

Para instalar la versión preliminar del SDK 5.0.x para compilar y 3.0.x para ejecutar pruebas destinadas a .NET Core 3.0.x, agregue este fragmento de código:

steps:
- task: UseDotNet@2
  inputs:
    version: '5.0.x'
    includePreviewVersions: true # Required for preview versions

- task: UseDotNet@2
  inputs:
    version: '3.0.x'
    packageType: runtime

Windows agentes ya incluyen un entorno de ejecución de .NET Core. Para instalar un SDK más reciente, establezca performMultiLevelLookup en en este fragmento de true código:

steps:
- task: UseDotNet@2
  displayName: 'Install .NET Core SDK'
  inputs:
    version: 5.0.x
    performMultiLevelLookup: true
    includePreviewVersions: true # Required for preview versions

Puede compilar los proyectos de .NET Core mediante el entorno SDK de .NET Core y runtime en Windows, Linux o macOS. Las compilaciones se ejecutan en un agente auto-hospedado. Asegúrese de que tiene instalada la versión necesaria del entorno SDK de .NET Core tiempo de ejecución en el agente.

Puede descargar paquetes NuGet desde Azure Artifacts, NuGet.org o desde algún otro repositorio NuGet externo. La tarea de .NET Core es especialmente útil para restaurar paquetes desde fuentes NuGet autenticadas.

Esta canalización usa una fuente de artefactos para dotnet restore en la CLI de .NET Core dotnet restore.

trigger:
- master

pool:
  vmImage: 'windows-latest'

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-vsts-feed' # A series of numbers and letters

- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    arguments: '--configuration $(buildConfiguration)'
  displayName: 'dotnet build $(buildConfiguration)'

Puede descargar paquetes NuGet desde NuGet.org.

En SDK de .NET Core versión 2.0 y posteriores, los paquetes se restauran automáticamente al ejecutar otros comandos, como dotnet build .

En SDK de .NET Core versión 2.0 y posteriores, los paquetes se restauran automáticamente al ejecutar otros comandos, como dotnet build . Sin embargo, es posible que tenga que usar la tarea .NET Core para restaurar paquetes si usa una fuente autenticada.

Si en ocasiones se producirá un error en las compilaciones al restaurar paquetes desde NuGet.org debido a problemas de conexión, puede usar Azure Artifacts con orígenes ascendentes y almacenar en caché los paquetes. Las credenciales de la canalización se usan automáticamente al conectarse a Azure Artifacts. Estas credenciales normalmente se derivan de la cuenta Project servicio de compilación de recopilación.

Si desea especificar un repositorio NuGet, coloque las direcciones URL en NuGet.config un archivo del repositorio. Si la fuente está autenticada, administre sus credenciales mediante la creación de una conexión NuGet servicio en la pestaña Servicios en Project Configuración.

Si usa agentes hospedados por Microsoft, obtiene una nueva máquina cada vez que ejecuta una compilación, lo que significa restaurar los paquetes cada vez. Esta restauración puede tardar una cantidad significativa de tiempo. Para mitigar este problema, puede usar Azure Artifacts o un agente auto-hospedado, en cuyo caso se obtiene la ventaja de usar la caché de paquetes.

Para restaurar paquetes desde una fuente personalizada externa, use la tarea .NET Core:

# do this before your build tasks
steps:
- task: DotNetCoreCLI@2
  displayName: Restore
  inputs:
    command: restore
    projects: '**/*.csproj'
    feedsToUse: config
    nugetConfigPath: NuGet.config    # Relative to root of the repository
    externalFeedCredentials: <Name of the NuGet service connection>
# ...

Para obtener más información sobre las NuGet de servicio, vea Publicar en NuGet fuente.

1. Seleccione Tareas en la canalización. Seleccione el trabajo que ejecuta las tareas de compilación. A + continuación, seleccione esta opción para agregar una nueva tarea a ese trabajo.

2. En el catálogo de tareas, busque y agregue la tarea .NET Core.

3. Seleccione la tarea y, en Comando, seleccione restaurar.

4. Especifique cualquier otra opción que necesite para esta tarea. A continuación, guarde la compilación.

Para compilar el proyecto mediante la tarea .NET Core, agregue el siguiente fragmento de código al azure-pipelines.yml archivo:

steps:
- task: DotNetCoreCLI@2
  displayName: Build
  inputs:
    command: build
    projects: '**/*.csproj'
    arguments: '--configuration $(buildConfiguration)' # Update this to match your need

Puede ejecutar cualquier comando dotnet personalizado en la canalización. En el ejemplo siguiente se muestra cómo instalar y usar una herramienta global de .NET, dotnetsay:

steps:
- task: DotNetCoreCLI@2
  displayName: 'Install dotnetsay'
  inputs:
    command: custom
    custom: tool
    arguments: 'install -g dotnetsay'

Build

1. Seleccione Tareas en la canalización. Seleccione el trabajo que ejecuta las tareas de compilación. A + continuación, seleccione esta opción para agregar una nueva tarea a ese trabajo.

2. En el catálogo de tareas, busque y agregue la tarea .NET Core.

3. Seleccione la tarea y, en Comando, seleccione compilar o publicar.

4. Especifique cualquier otra opción que necesite para esta tarea. A continuación, guarde la compilación.

Instalación de una herramienta

Para instalar una herramienta global de .NET Core como dotnetsay en la compilación que se ejecuta Windows, siga estos pasos:

1. Agregue la tarea .NET Core y establezca las siguientes propiedades:

   • Comando: personalizado.
     • Ruta de acceso a los proyectos:deje vacío.
   • Comando personalizado:herramienta.
   • Argumentos: .

2. Agregue una tarea línea de comandos y establezca las siguientes propiedades:

   • Script: .

Agregue el siguiente fragmento de código al azure-pipelines.yml archivo:

steps:
# ...
# do this after other tasks such as building
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration)'

Una alternativa consiste en ejecutar el comando con un registrador específico y, dotnet test a continuación, usar la dotnet test tarea:

steps:
# ...
# do this after your tests have run
- script: dotnet test <test-project> --logger trx
- task: PublishTestResults@2
  condition: succeededOrFailed()
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

Use la tarea .NET Core con el conjunto de comandos para probar. La ruta de acceso a los proyectos debe hacer referencia a los proyectos de prueba de la solución.

Agregue el siguiente fragmento de código al azure-pipelines.yml archivo:

steps:
# ...
# do this after other tasks such as building
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration) --collect "Code coverage"'

Si decide ejecutar el comando, especifique el registrador de resultados de dotnet test pruebas y las opciones de cobertura. A continuación, use la Resultados de pruebas tarea Publicar:

steps:
# ...
# do this after your tests have run
- script: dotnet test <test-project> --logger trx --collect "Code coverage"
- task: PublishTestResults@2
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

1. Agregue la tarea .NET Core al trabajo de compilación y establezca las siguientes propiedades:

   • Comando: test.
   • Ruta de acceso alos proyectos: debe hacer referencia a los proyectos de prueba de la solución.
   • Argumentos: .

2. Asegúrese de que la opción Publicar resultados de pruebas permanece seleccionada.

Publicar artefactos en Azure Pipelines

Para publicar la salida de la compilación de .NET,

• Ejecute dotnet publish --output $(Build.ArtifactStagingDirectory) en la CLI o agregue la DotNetCoreCLI@2 tarea con el comando publish.
• Publique el artefacto mediante la tarea Publicar artefacto.

Agregue el siguiente fragmento de código al azure-pipelines.yml archivo:

steps:

- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

# this code takes all the files in $(Build.ArtifactStagingDirectory) and uploads them as an artifact of your build.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Build.ArtifactStagingDirectory)' 
    artifactName: 'myWebsiteName'

Para copiar más archivos en el directorio de compilación antes de la publicación, use la Utilidad: copiar archivos.

Publicar en una fuente NuGet datos

Para crear y publicar un paquete NuGet, agregue el siguiente fragmento de código:

steps:
# ...
# do this near the end of your pipeline in most cases
- script: dotnet pack /p:PackageVersion=$(version)  # define version variable elsewhere in your pipeline
- task: NuGetAuthenticate@0
  input:
    nuGetServiceConnections: '<Name of the NuGet service connection>'
- task: NuGetCommand@2
  inputs:
    command: push
    nuGetFeedType: external
    publishFeedCredentials: '<Name of the NuGet service connection>'
    versioningScheme: byEnvVar
    versionEnvVar: version

Para obtener más información sobre el control de versiones y la publicación NuGet paquetes,vea Publicar en NuGet fuente .

Implementación de una aplicación sitio

Para crear un .zip de archivos que esté listo para publicarse en una aplicación web, agregue el siguiente fragmento de código:

steps:
# ...
# do this after you've built your app, near the end of your pipeline in most cases
# for example, you do this before you deploy to an Azure web app on Windows
- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

Para publicar este archivo en una aplicación web, consulte Implementación de Azure Web Apps .

Publicar artefactos en Azure Pipelines

Use la tarea Publicar Artifacts para publicar la salida de la compilación en Azure Pipelines o TFS.

Publicar en una fuente NuGet datos

Si desea publicar el código en una fuente de NuGet, siga estos pasos:

1. Use una tarea de .NET Core con el comando establecido en pack.

2. Publique el paquete en una NuGet de distribución.

Implementación de una aplicación sitio

1. Use una tarea de .NET Core con el conjunto de comandos para publicar.

2. Asegúrese de que ha seleccionado la opción para crear un archivo .zip archivo.

3. Para publicar este archivo en una aplicación web, consulte Implementación de Azure Web Apps .

• No instalamos versiones preliminares de la versión preliminar de SDK de .NET Core en agentes hospedados por Microsoft. Una vez publicada una nueva versión del SDK de .NET Core, podemos tardar unas semanas en publicarla en todos los centros de datos en los que Azure Pipelines se ejecuten. No tiene que esperar a que finalicemos este lanzamiento. Puede usar el Instalador de herramientas de .NET Core,como se explica en esta guía, para instalar la versión deseada de la SDK de .NET Core en agentes hospedados por Microsoft.

¿No está Azure Pipelines? Si es así, se recomienda probar esta sección antes de pasar a otras secciones.