Publicación de paquetes NuGet con Azure Pipelines (YAML/clásico)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Con Azure Pipelines, puede publicar los paquetes NuGet en las fuentes de Azure Artifacts de su organización, en otras organizaciones y en registros públicos como nuget.org, mediante canalizaciones clásicas o YAML. En este artículo, aprenderá a:

• Publicación de paquetes en una fuente interna
• Publicación de paquetes en una fuente de otra organización
• Control de versiones de paquetes

Requisitos previos

• Cree una organización de Azure DevOps y un proyecto si aún no lo ha hecho.

• Cree una fuente nueva si todavía no tiene una.

• Si usa un agente autohospedado, asegúrese de que tiene instalado el SDK de .NET Core (2.1.400+) y NuGet (4.8.0.5385+).

Publicación de paquetes NuGet en una fuente de la misma organización

Nota:

Para publicar los paquetes en una fuente mediante Azure Pipelines, asegúrese de que tanto el Servicio de compilación de colecciones de proyectos como las identidades de Servicio de compilación del proyecto tengan el rol de Publicador de fuentes (colaborador) asignado en la configuración de la fuente. Consulte Administración de permisos para obtener más información.

YAML

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

2. Seleccione Pipelines y elija la definición correspondiente.

3. Seleccione Editar y agregue el siguiente fragmento de código a la canalización YAML.

steps:
- task: NuGetToolInstaller@1                            # Minimum required NuGet version: 4.8.0.5385+.
  displayName: 'NuGet Tool Installer'

- task: NuGetAuthenticate@1
  displayName: 'NuGet Authenticate'

- script: |
      nuget.exe push --source "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" --api-key az $(Build.ArtifactStagingDirectory)\*.nupkg
  displayName: Push

Clásico

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

2. Seleccione Pipelines y elija la definición correspondiente.

3. Seleccione Editar y luego elija el signo + para agregar una nueva tarea. Agregue las tareas Instalador de la herramienta NuGet, Autenticación de NuGet y Línea de comandos a la definición de la canalización. Puede dejar las tareas Instalador de la herramienta NuGet y Autenticación de NuGet con su configuración predeterminada y configurar la tarea Línea de comandos de la siguiente manera:

   

   • Nombre para mostrar: Inserción.
   • Script:

     nuget.exe push --source "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" --api-key az $(Build.ArtifactStagingDirectory)\*.nupkg
     

Publicación de paquetes NuGet en una fuente de otra organización

Para publicar los paquetes NuGet en una fuente de otra organización de Azure DevOps, primero debe crear un token de acceso personal (PAT) en la organización de destino. Vaya a la organización que hospeda la fuente de destino y Cree un token de acceso personal con el ámbito Empaquetado>Lectura y escritura. Una vez creado el PAT, copie y almacénelo en una ubicación segura, ya que lo necesitará en la sección siguiente para configurar una conexión de servicio.

1. Inicie sesión en la organización de Azure DevOps donde se ejecutará la canalización y, a continuación, vaya al proyecto.

2. Vaya a Configuración del proyecto>Conexiones de servicio.

3. Seleccione Nueva conexión de servicio, NuGet y, a continuación, Siguiente.

4. Seleccione Servidor externo de Azure DevOps como Método de autenticación y escriba la URL de la fuente de destino. Pegue el token de acceso personal que creó anteriormente, proporcione un nombre para la conexión de servicio y active Conceder permiso de acceso a todas las canalizaciones si es aplicable a su escenario.

5. Cuando haya terminado, haga clic en Guardar.

   

YAML

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

2. Seleccione Pipelines y elija la definición correspondiente.

3. Seleccione Editar y agregue el siguiente fragmento de código a la canalización YAML.

   - task: NuGetToolInstaller@1                                # Minimum required NuGet version: 4.8.0.5385+.
     displayName: 'NuGet Tool Installer'
   
   - task: NuGetAuthenticate@1
     inputs:
       nuGetServiceConnections: <SERVICE_CONNECTION_NAME>
   
   - script: |
         nuget.exe push --source "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" --api-key az $(Build.ArtifactStagingDirectory)\*.nupkg
     displayName: Push       
   

Clásico

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

2. Seleccione Pipelines y elija la definición correspondiente.

3. Seleccione Editar y luego elija el signo + para agregar una nueva tarea. Agregue las tareas Instalador de la herramienta NuGet, Autenticación de NuGet y Línea de comandos a la definición de la canalización. Puede dejar Instalador de la herramienta NuGet con su configuración predeterminada y configurar las demás tareas de la siguiente manera:

   

   1. Tarea de autenticación de NuGet: seleccione la conexión de servicio en el menú desplegable Credenciales de conexión de servicio para fuentes fuera de esta organización.

   2. Tarea de línea de comandos:

      • Nombre para mostrar: Inserción.
      • Script:

        nuget.exe push --source "https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" --api-key az $(Build.ArtifactStagingDirectory)\*.nupkg
        

Control de versiones de paquetes de tareas NuGet

Azure Pipelines admite el control de versiones semánticas y ofrece las siguientes opciones de configuración para las tareas de NuGet:

• Uso de la fecha y hora (clásico) | byPrereleaseNumber (YAML): la versión del paquete seguirá el formato: Major.Minor.Patch-ci-datetime , donde tiene la flexibilidad de personalizar los valores de principal, secundaria y revisión.

• Uso de una variable de entorno (clásico) | byEnvVar (YAML): la versión del paquete se establece en el valor de la variable de entorno especificada.

• Uso del número de compilación (clásico) | byBuildNumber (YAML): la versión del paquete se establece en el número de compilación. Asegúrese de definir el formato del número de compilación en las Opciones de canalización como $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r). Para especificar el formato en YAML, agregue una propiedad name: en la raíz de la canalización y defina el formato.

A continuación se muestra un ejemplo que muestra cómo usar el control de versiones de fecha y hora para generar un paquete compatible con SemVer con el formato: Major.Minor.Patch-ci-datetime.

YAML

variables:
  Major: '1'
  Minor: '0'
  Patch: '0'

steps:
- task: NuGetCommand@2
  inputs:
    command: pack
    versioningScheme: byPrereleaseNumber
    majorVersion: '$(Major)'
    minorVersion: '$(Minor)'
    patchVersion: '$(Patch)'

Nota:

Los paquetes DotNetCore y DotNetStandard deben empaquetarse con la tarea DotNetCoreCLI@2 para evitar System.InvalidCastExceptions. Consulte la tarea de la CLI de .NET Core para obtener más detalles.

task: DotNetCoreCLI@2
inputs:
    command: pack
    versioningScheme: byPrereleaseNumber
    majorVersion: '$(Major)'
    minorVersion: '$(Minor)'
    patchVersion: '$(Patch)'

Clásico

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

2. Seleccione Pipelines y elija la definición correspondiente.

3. Seleccione Editar y, a continuación seleccione u tarea de NuGet.

4. Asegúrese de que el comando está establecido en paquete y, a continuación, en Opciones del paquete, seleccione Usar fecha y hora en el menú desplegable.

   

Contenido relacionado

• Publicación de paquetes NuGet en NuGet.org
• Uso de paquetes del upstream de NuGet.org
• Publicación y descarga de Universal Packages