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

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

Con Azure Pipelines, puede publicar los paquetes de npm en fuentes de Azure Artifacts dentro de su organización y en otras organizaciones. Este artículo le guiará a través de la publicación de los paquetes npm en fuentes internas y externas mediante canalizaciones YAML y clásicas.

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 Node.js y npm.

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

Nota:

Para publicar los paquetes en una fuente mediante Azure Pipelines, asegúrese de que tanto la identidad de Servicio de compilación de colecciones de proyectos y de Servicio de compilación del proyecto están configurados como Publicador de fuentes (colaborador) para publicar los paquetes en una fuente mediante Azure Pipelines. Consulte Agregar nuevos usuarios o grupos para obtener más detalles.

YAML

steps:
- task: NodeTool@0
  inputs:
    checkLatest: true

- task: npmAuthenticate@0
  displayName: 'Authenticate to Azure Artifacts feed'
  inputs:
    workingFile: .npmrc

- script: |
   npm publish
  displayName: Publish

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 del instalador de la herramienta Node.js, npm Authenticate y Command line a la definición de la canalización. Puede dejar la tarea del instalador de herramientas de Node.js con los valores predeterminados y configurar las tareas de la línea de comandos y autenticación de npm como se indica a continuación:

   1. Tarea Autenticar npm: seleccione la ruta de acceso al archivo .npmrc .

   2. Tarea de línea de comandos:

      • Nombre para mostrar: Publicar.
      • Script:

        npm publish
        

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

Para publicar los paquetes en una fuente en otra organización de Azure DevOps, primero debe crear un token de acceso personal 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. Copie el token de acceso personal, ya que lo necesitará en la sección siguiente.

Creación de 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, npm y, después, Siguiente.

4. Seleccione Nombre de usuario y Contraseña como método de autenticación y escriba la dirección URL del Registro. Escriba el nombre de usuario (un marcador de posición, ya que Azure Pipelines usará .npmrc el archivo de configuración y el token de acceso personal que creó anteriormente para autenticarse). En Contraseña, pegue el token de acceso personal. Proporcione un nombre para la conexión de servicio y active la casilla Conceder permiso de acceso a todas las canalizaciones .

5. Cuando haya terminado, haga clic en Guardar.

Publicar paquetes

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: NodeTool@0
     inputs:
       checkLatest: true
   
   - task: npmAuthenticate@0
     displayName: 'Authenticate to Azure Artifacts feed'
     inputs:
       workingFile: .npmrc
       customEndpoint: <SERVICE_CONNECTION_NAME>
   
   - script: |
      npm publish  
     displayName: Publish  
   

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 del instalador de la herramienta Node.js, npm Authenticate y Command line a la definición de la canalización. Puede dejar la tarea del instalador de herramientas de Node.js con los valores predeterminados y configurar las tareas de la línea de comandos y autenticación de npm como se indica a continuación:

   1. Tarea autenticación de npm:

      1. Seleccione la ruta de acceso al archivo .npmrc .
      2. Seleccione la conexión de servicio que creó anteriormente en el menú desplegable Credenciales para registros fuera de esta organización o colección .

   2. Tarea de línea de comandos:

      • Nombre para mostrar: Publicar.
      • Script:

        npm publish
        

Contenido relacionado

• Publicación y descarga de artefactos de canalización
• Uso del archivo .artifactignore
• Implemente artefactos de solicitud de incorporación de cambios.