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 npm en fuentes de Azure Artifacts y en registros públicos, como npmjs.com. Este artículo le guiará para saber cómo publicar paquetes npm mediante procesos de YAML y Classic.

Requisitos previos

• Una organización de Azure DevOps. cree una de forma gratuita.

• Un proyecto de Azure DevOps. Cree un nuevo proyecto si aún no ha creado ninguno.

• Una fuente de Azure Artifacts. cree una de forma gratuita.

Publicación en fuentes de Azure Artifacts

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

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useFeed
    publishFeed: <FEED_NAME>        ## For project-scoped feeds, use: <PROJECT_NAME>/<FEED_NAME> 

• publishRegistry: seleccione useFeed para usar una fuente dentro de la organización. Opciones: useExternalRegistry, useFeed
• publishFeed: la fuente en la que quiere publicar. Obligatorio cuando publishRegistry = useFeed.

Sugerencia

Al agregar la tarea npm al proceso de YAML mediante el editor de YAML, se generarán automáticamente los ID de proyecto y de fuente en publishFeed.

Clásico

1. Vaya al portal de Azure DevOps y después seleccione el proyecto.

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

3. Seleccione Editar y luego elija el signo + para agregar una nueva tarea. Busque la tarea npm y luego seleccione Agregar para agregarla al proceso.

   

4. Asigne un nombre a la tarea y luego seleccione Publicar en el menú desplegable de comandos. Indique la ruta de package.json, la ubicación del registro y el registro de destino.

   • Carpeta de trabajo que contiene package.json: ruta de acceso a la carpeta que contiene los archivos package.json y .npmrc de destino. Déjelo en blanco si esos archivos están en la raíz del repositorio.
   • Ubicación del registro: seleccione Registro que selecciono aquí para publicar en una fuente.
   • Registro de destino: seleccione la fuente en el menú desplegable.

   

Publicación en un registro público

Antes de publicar los paquetes en un registro npm público, como npmjs.com, primero debe crear una conexión de servicio para autenticarse en el servicio externo deseado.

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

2. Seleccione Configuración del proyecto>Conexiones de servicio y luego seleccione Crear conexión de servicio.

   

3. Seleccione npm y, a continuación, Siguiente. Rellene los campos necesarios y seleccione Guardar cuando haya terminado.

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useExternalRegistry
    publishEndpoint: '<NAME_OF_YOUR_SERVICE_CONNECTION>'

• publishRegistry: seleccione useExternalRegistry para publicar en un registro público. Opciones: useExternalRegistry | useFeed.
• publishEndpoint: reemplace el marcador de posición por el nombre de la conexión de servicio creada anteriormente. Obligatorio cuando publishRegistry == useExternalRegistry.

Clásico

1. Vaya al portal de Azure DevOps y después seleccione el proyecto.

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

3. Seleccione Editar y luego elija el signo + para agregar una nueva tarea. Busque la tarea npm y luego seleccione Agregar para agregarla al proceso.

   

4. Asigne un nombre a la tarea y luego seleccione Publicar en el menú desplegable de comandos. Indique la ruta de acceso a package.json, la Ubicación de registro y el Registro externo.

   • Carpeta de trabajo que contiene package.json: ruta de acceso a la carpeta que contiene los archivos package.json y .npmrc de destino. Déjelo en blanco si esos archivos están en la raíz del repositorio.
   • Ubicación de registro: seleccione Registro npm externo para publicar en un registro público, como npmjs.com.
   • Registro externo: seleccione la conexión de servicio que creó anteriormente.

   

Artículos relacionados

• Publicar y restaurar paquetes npm en la línea de comandos.
• Usar paquetes de npmjs.com.
• Publicación y descarga de artefactos de procesos.