NuGet tarea

Versión 2.

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

Use esta tarea para instalar y actualizar NuGet de paquetes o empaquetar y publicar NuGet paquetes. Usa NuGet.exe y funciona con .NET Framework aplicaciones. En el caso de .NET Core .NET Standard aplicaciones, use la tarea .NET Core.

Si el código depende de NuGet paquetes, asegúrese de agregar este paso antes de Visual Studio de compilación. Asegúrese también de borrar la casilla Restaurar NuGet paquetes en desuso en ese paso.

Si está trabajando con .NET Core o .NET Standard, use la tarea .NET Core, que es totalmente compatible con todos los escenarios de paquetes y actualmente es compatible con dotnet.

# NuGet
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
  inputs:
    #command: 'restore' # Options: restore, pack, push, custom
    #restoreSolution: '**/*.sln' # Required when command == Restore
    #feedsToUse: 'select' # Options: select, config
    #vstsFeed: # Required when feedsToUse == Select
    #includeNuGetOrg: true # Required when feedsToUse == Select
    #nugetConfigPath: # Required when feedsToUse == Config
    #externalFeedCredentials: # Optional
    #noCache: false 
    #disableParallelProcessing: false 
    restoreDirectory: 
    #verbosityRestore: 'Detailed' # Options: quiet, normal, detailed
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # Required when command == Push
    #nuGetFeedType: 'internal' # Required when command == Push# Options: internal, external
    #publishVstsFeed: # Required when command == Push && NuGetFeedType == Internal
    #publishPackageMetadata: true # Optional
    #allowPackageConflicts: # Optional
    #publishFeedCredentials: # Required when command == Push && NuGetFeedType == External
    #verbosityPush: 'Detailed' # Options: quiet, normal, detailed
    #packagesToPack: '**/*.csproj' # Required when command == Pack
    #configuration: '$(BuildConfiguration)' # Optional
    #packDestination: '$(Build.ArtifactStagingDirectory)' # Optional
    #versioningScheme: 'off' # Options: off, byPrereleaseNumber, byEnvVar, byBuildNumber
    #includeReferencedProjects: false # Optional
    #versionEnvVar: # Required when versioningScheme == ByEnvVar
    #majorVersion: '1' # Required when versioningScheme == ByPrereleaseNumber
    #minorVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
    #patchVersion: '0' # Required when versioningScheme == ByPrereleaseNumber
    #packTimezone: 'utc' # Required when versioningScheme == ByPrereleaseNumber# Options: utc, local
    #includeSymbols: false # Optional
    #toolPackage: # Optional
    #buildProperties: # Optional
    #basePath: # Optional, specify path to nuspec files
    #verbosityPack: 'Detailed' # Options: quiet, normal, detailed
    #arguments: # Required when command == Custom

Argumentos

Ejemplos

Restauración

Restaure todas las soluciones con paquetes de una fuente seleccionada.

# Restore from a project scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-project/my-project-scoped-feed'
    includeNuGetOrg: false
    restoreSolution: '**/*.sln'

# Restore from an organization scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-organization-scoped-feed'
    restoreSolution: '**/*.sln'

# Restore from a feed in a different organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: config
    nugetConfigPath: ./nuget.config
    restoreSolution: '**/*.sln'
    externalFeedCredentials: 'MyServiceConnectionName'
    noCache: true
  continueOnError: true

# Restore from feed(s) set in nuget.config
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'config'
    nugetConfigPath: 'nuget.config'

Paquete

Cree un NuGet en la carpeta de destino.

# Package a project
- task: NuGetCommand@2
  inputs:
    command: 'pack'
    packagesToPack: '**/*.csproj'
    packDestination: '$(Build.ArtifactStagingDirectory)'

Insertar

• Insertar o publicar un paquete en una fuente definida en la NuGet.config.

  # Push a project
  - task: NuGetCommand@2
    inputs:
      command: 'push'
      packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
      feedsToUse: 'config'
      nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
  

• Inserción o publicación de un paquete en un proyecto con ámbito

  # Push a project
  - task: NuGetCommand@2
    inputs:
      command: 'push'
      feedsToUse: 'select'
      vstsFeed: 'my-project/my-project-scoped-feed'
      publishVstsFeed: 'myTestFeed'
  

• Inserción o publicación de un paquete en NuGet.org

  # Push a project
  - task: NuGetCommand@2
    inputs:
      command: 'push'
      feedsToUse: 'config'
      includeNugetOrg: 'true'
  

Personalizado

Ejecute cualquier otro NuGet comando que no sea el predeterminado: empaquetar, insertar y restaurar.

# list local NuGet resources.
- task: NuGetCommand@2
  displayName: 'list locals'
  inputs:
    command: custom
    arguments: 'locals all -list'

De código abierto

Consulte las tareas Azure Pipelines y Team Foundation Server de forma lista para su uso en GitHub. Los comentarios y las contribuciones son bienvenidos.

Preguntas más frecuentes

¿Por qué debo comprobar una NuGet.Config?

La comprobación de NuGet.Config en el control de código fuente garantiza que un fragmento de información clave necesario 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.

¿Dónde puedo obtener información sobre Azure Artifacts?

Documentación de Azure Artifacts

¿Dónde puedo obtener más información sobre NuGet?

NuGet de docs

NuGet crear empaquetado y publicación

NuGet usar Configuración de una solución para obtener dependencias

¿Qué otros tipos de aplicaciones puedo compilar?

Compilación e implementación de ejemplos de aplicaciones

¿Qué otros tipos de tareas de compilación están disponibles?

Catálogo de tareas de compilación y versión

¿Cómo se protege el código base de los saltos de compilación?

• Git: mejore la calidad del código con directivas de rama con una opción para requerir que el código se compile antes de que se pueda combinar en una rama. Para GitHub repositorios, hay directivas similares disponibles en la configuración del repositorio de GitHub en Ramas.

• TFVC: use el registro de entrada en puerta.

Cómo modificar otras partes de la canalización de compilación?

• Tareas de compilación y versión para ejecutar pruebas, scripts y una amplia gama de otros procesos.

• Especifique opciones de compilación como especificar cómo se denominan las compilaciones completadas, crear varias configuraciones y crear elementos de trabajo en caso de error.

• Repositorios de origen admitidos para elegir el origen de la compilación y modificar opciones como cómo se limpia el área de trabajo del agente.

• Establezca desencadenadores de compilación para modificar cómo se ejecutan las compilaciones de CI y para especificar compilaciones programadas.

• Especifique directivas de retención de compilación para eliminar automáticamente las compilaciones antiguas.

He seleccionado varias configuraciones paralelas, pero solo se ejecuta una compilación a la vez.

Si usa Azure Pipelines, es posible que necesite más trabajos paralelos. Vea Trabajos paralelos en Azure Pipelines.

Cómo ver qué ha cambiado en mi canalización de compilación?

Visualización del historial de cambios de la canalización de compilación

¿Necesito un agente?

Necesita al menos un agente para ejecutar la compilación o versión.

Tengo problemas. ¿Cómo puedo solucionarlos?

Vea Solución de problemas de compilación y versión.

No se puede seleccionar un grupo de agentes predeterminado y no se puede poner en cola la compilación o versión. ¿Cómo puedo corregirlo?

Vea Grupos de agentes.

La tarea de envío de cambios de NuGet genera el error siguiente: "Error: no se puede obtener el certificado del emisor local". ¿Cómo lo puedo corregir?

Esto se puede corregir si se añade un certificado raíz de confianza. Puede agregar la variable de entorno NODE_EXTRA_CA_CERTS=file al agente de compilación, o bien la variable de tarea NODE.EXTRA.CA.CERTS=file en la canalización. Vea la documentación de Node.js para obtener más detalles sobre esta variable. Consulte Establecimiento de variables en una canalización para obtener instrucciones sobre cómo establecer una variable en la canalización.

Mi canalización necesita acceder a una fuente en un proyecto diferente

Si la canalización se ejecuta en un proyecto diferente al proyecto que hospeda la fuente, debe configurar el otro proyecto para conceder acceso de lectura y escritura al servicio de compilación. Consulte Permisos de paquete en Azure Pipelines para obtener más detalles.