Tarea de la CLI de .NET Core

Azure Pipelines | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Azure Pipelines

Use esta tarea para compilar, probar, empaquetar o publicar una aplicación dotnet, o para ejecutar un comando dotnet personalizado. Para los comandos de paquete, esta tarea admite NuGet.org y fuentes autenticadas como Administración de paquetes y MyGet.

Si la compilación de .NET Core o .NET Standard depende de paquetes NuGet, asegúrese de agregar dos copias de este paso: una con el comando y otra restore con el build comando .

# .NET Core
# Build, test, package, or publish a dotnet application, or run a custom dotnet command
- task: DotNetCoreCLI@2
  inputs:
    #command: 'build' # Options: build, push, pack, publish, restore, run, test, custom
    #publishWebProjects: true # Required when command == Publish
    #projects: # Optional
    #custom: # Required when command == Custom
    #arguments: # Optional
    #publishTestResults: true # Optional
    #testRunTitle: # Optional
    #zipAfterPublish: true # Optional
    #modifyOutputPath: true # Optional
    #feedsToUse: 'select' # Options: select, config
    #vstsFeed: # Required when feedsToUse == Select
    #feedRestore: # Required when command == restore. projectName/feedName for project-scoped feed. FeedName only for organization-scoped feed.
    #includeNuGetOrg: true # Required when feedsToUse == Select
    #nugetConfigPath: # Required when feedsToUse == Config
    #externalFeedCredentials: # Optional
    #noCache: false
    restoreDirectory:
    #restoreArguments: # Optional
    #verbosityRestore: 'Detailed' # Options: -, quiet, minimal, normal, detailed, diagnostic
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # Required when command == Push
    #nuGetFeedType: 'internal' # Required when command == Push# Options: internal, external
    #publishVstsFeed: # Required when command == Push && NuGetFeedType == Internal
    #publishPackageMetadata: true # Optional
    #publishFeedCredentials: # Required when command == Push && NuGetFeedType == External
    #packagesToPack: '**/*.csproj' # Required when command == Pack
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # Optional
    #nobuild: false # Optional
    #includesymbols: false # Optional
    #includesource: false # Optional
    #versioningScheme: 'off' # Options: off, byPrereleaseNumber, byEnvVar, byBuildNumber
    #versionEnvVar: # Required when versioningScheme == byEnvVar
    #majorVersion: '1' # Required when versioningScheme == ByPrereleaseNumber
    #minorVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
    #patchVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
    #buildProperties: # Optional
    #verbosityPack: 'Detailed' # Options: -, quiet, minimal, normal, detailed, diagnostic
    workingDirectory:

Argumentos

Opciones de control de tareas

Ejemplos

Build

Compilar un proyecto

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'

Compilar varios proyectos

# Build multiple projects
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    projects: |
      src/proj1/proj1.csproj 
      src/proj2/proj2.csproj 
      src/other/other.sln    # Pass a solution instead of a csproj.

Insertar

Inserción NuGet paquetes en la fuente interna

# Push non test NuGet packages from a build to internal organization Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    searchPatternPush: '$(Build.ArtifactStagingDirectory)/*.nupkg;!$(Build.ArtifactStagingDirectory)/*.Tests.nupkg'
    feedPublish: 'FabrikamFeed'

Inserción NuGet paquetes en la fuente externa

# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    nugetFeedType: 'external'
    externalEndPoint: 'MyNuGetServiceConnection'

Pack

Empaquetar un Paquete NuGet en un directorio de salida específico

# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'

Empaquetar un paquete de símbolos

# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    includesymbols: true

Publicar

Publicación de proyectos en la carpeta especificada

# Publish projects to specified folder.
- task: DotNetCoreCLI@2
  displayName: 'dotnet publish'
  inputs:
    command: 'publish'
    publishWebProjects: false
    projects: '**/*.csproj'
    arguments: '-o $(Build.ArtifactStagingDirectory)/Output'
    zipAfterPublish: true
    modifyOutputPath: true

Restauración

#Restore packages with the .NET Core CLI task
- task: DotNetCoreCLI@2
  displayName: 'dotnet restore'
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    feedRestore: 'projectName/feedName'
    projects: '**/*.csproj'
    includeNuGetOrg: true

Prueba

Ejecución de pruebas en el repositorio

# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
  inputs:
    command: 'test'

Preguntas más frecuentes

¿Por qué mi paso de compilación, publicación o prueba no puede restaurar paquetes?

La dotnet mayoría de los comandos, buildpublish incluidos , e incluyen un paso testrestore implícito. Esto producirá un error en las fuentes autenticadas, incluso si ejecutó correctamente en un paso anterior, porque el paso anterior habrá limpiado las dotnet restore credenciales que usó.

Para corregir este problema, agregue la --no-restore marca al cuadro de texto Argumentos .

Además, el comando no reconoce los argumentos o y las fuentes especificados de esta manera no se incluirán en el archivo NuGet.config generado cuando se ejecute testfeedRestore el paso vstsFeedrestore implícito. Se recomienda usar un paso explícito dotnet restore para restaurar paquetes. El restore comando respeta los feedRestorevstsFeed argumentos y .

¿Por qué debo comprobar un NuGet.config?

La comprobación de NuGet.config en el control de código fuente garantiza que una parte clave de la información necesaria para compilar el proyecto (la ubicación de sus paquetes) está disponible para todos los desarrolladores que comprueban el código.

Sin embargo, en situaciones en las que un equipo de desarrolladores trabaja en una gran variedad de proyectos, también es posible agregar una fuente de Azure Artifacts a la NuGet.config global en la máquina de cada desarrollador. En estas situaciones, el uso de la opción "Fuentes que selecciono aquí" en la tarea NuGet replica esta configuración.

Solución de problemas

La estructura de archivos para los archivos de salida es diferente de las compilaciones anteriores

Azure DevOps los agentes hospedados se configuran con .NET Core 3.0, 2.1 y 2.2. La CLI de .NET Core 3.0 tiene un comportamiento diferente al publicar proyectos mediante el argumento de carpeta de salida. Al publicar proyectos con el argumento de carpeta de salida (-o), la carpeta de salida se crea en el directorio raíz y no en el directorio del archivo de proyecto. Por lo tanto, al publicar más de un proyecto, todos los archivos se publican en el mismo directorio, lo que provoca un problema.

Para resolver este problema, use el parámetro Add project name to publish path (modifyOutputPath in YAML) (Agregar nombre de proyecto para publicar ruta de acceso [modifyOutputPath en YAML]) en CLI de .NET Core tarea. Esto crea una sub carpeta con el nombre del archivo de proyecto, dentro de la carpeta de salida. Por lo tanto, todos los proyectos se publicarán en subcarpetas diferentes dentro de la carpeta de salida principal.

steps:
- task: DotNetCoreCLI@2
  displayName: 'dotnet publish'
  inputs:
    command: publish
    publishWebProjects: false
    projects: '**/*.csproj'
    arguments: '-o testpath'
    zipAfterPublish: false
    modifyOutputPath: true

Project uso de Entity Framework ha dejado de funcionar en agentes hospedados

La versión más reciente de .NET Core: 3.0 no tiene Entity Framework (EF) integrado. Tendrá que instalar EF antes de comenzar la ejecución o agregar global.json al proyecto con la versión SDK de .NET Core necesaria. Esto garantizará que se usa el SDK correcto para compilar el proyecto de EF. Si la versión necesaria no está presente en la máquina, agregue la tarea UseDotNetV2 a la canalización para instalar la versión necesaria. Más información sobre EF con .NET Core 3.0

Código abierto

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