Publicación y descarga de paquetes de npm con Azure Artifacts

Servicios de Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts permite a los desarrolladores publicar y descargar paquetes npm desde fuentes o registros públicos.

Este artículo le guía a través de la creación de una fuente, la configuración del proyecto y la publicación y descarga de paquetes npm.

Requisitos previos

Crear una fuente

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

  2. Seleccione Artefactos y, a continuación, Crear feed.

  3. Introduzca un Nombre para su canal.

  4. Elija una configuración de Visibilidad para controlar quién puede ver los paquetes en la fuente.

  5. Seleccione Incluir paquetes de orígenes públicos comunes si quiere que la fuente use paquetes ascendentes de orígenes como nuget.org o npmjs.com.

  6. En Ámbito, elija si la fuente tiene como ámbito el proyecto actual o toda la organización.

  7. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps Services.

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

  2. Seleccione Artefactos y, a continuación, Crear feed.

  3. Introduzca un Nombre para su canal.

  4. Elija una configuración de Visibilidad para controlar quién puede ver los paquetes en la fuente.

  5. Seleccione Incluir paquetes de orígenes públicos comunes si quiere que la fuente use paquetes ascendentes de orígenes como nuget.org o npmjs.com.

  6. En Ámbito, elija si la fuente tiene como ámbito el proyecto actual o toda la organización.

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2022.

Nota:

Al crear una fuente, la cuenta Build Service del proyecto, como projectName Build Service (orgName), tiene asignado de forma predeterminada el rol Feed and Upstream Reader (Collaborator).

Configuración de la autenticación de npm

Antes de conectar con una fuente, configura la autenticación del cliente npm en tu equipo. Los pasos difieren en función del sistema operativo:

Windows

Instale vsts-npm-auth, que genera y actualiza las credenciales que usa npm para conectarse a la fuente de Azure Artifacts.

npm install -g vsts-npm-auth --registry https://registry.npmjs.com

macOS y Linux

vsts-npm-auth no se admite en macOS o Linux. En su lugar, cree un token de acceso personal (PAT) con el ámbito Empaquetado>. Use ese PAT al configurar el archivo .npmrc de nivel de usuario en la sección siguiente.

Conexión a una fuente

Azure Artifacts recomienda usar dos archivos de configuración independientes. La primera debe mantenerse localmente en el directorio $HOME (Linux/macOS) o $env. HOME (Windows) para almacenar de forma segura sus credenciales. Esto permite que el cliente npm acceda a sus credenciales para la autenticación.

Con esta configuración, puede compartir la configuración del proyecto con el equipo sin exponer las credenciales en el control de código fuente. Para obtener más información, consulte Conexión a una fuente de Azure Artifacts - npm.

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

  2. Seleccione Artefactos, seleccione la fuente en el menú desplegable y, a continuación, seleccione Conectar a la fuente.

  3. Seleccione npm en el panel de navegación izquierdo.

  4. En Configuración del proyecto, seleccione Windows u Otro para su sistema operativo y, a continuación, siga las instrucciones proporcionadas para actualizar los archivos .npmrc de usuario y de proyecto.

    Captura de pantalla que muestra cómo configurar un proyecto de npm y conectarse a una fuente en Azure DevOps Services.

Nota:

El vsts-npm-auth no es compatible con Azure DevOps Server.

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

  2. Seleccione Artefactos, seleccione la fuente en el menú desplegable y, a continuación, seleccione Conectar a la fuente.

  3. Seleccione npm en el panel de navegación izquierdo.

  4. En Configuración del proyecto, seleccione Windows u Otro para su sistema operativo y, a continuación, siga las instrucciones proporcionadas para actualizar los archivos .npmrc de nivel de usuario y de proyecto.

    Captura de pantalla que muestra cómo configurar un proyecto de npm y conectarse a una fuente de Azure Artifacts en Azure DevOps Server 2022.

Importante

npm solo admite una configuración única registry en el archivo .npmrc . Si necesita paquetes de varias fuentes, use orígenes ascendentes o ámbitos en lugar de agregar varias entradas registry.

Publica paquetes en tu feed

Nota:

Para publicar paquetes en un feed, debe ser Feed Publisher (Colaborador) o superior. Consulte Administración de permisos para obtener más información.

Antes de publicar paquetes, asegúrese de autenticarse en su feed. Si aún no lo ha hecho, siga los pasos descritos en la sección Conexión a una fuente y continúe con las instrucciones de la sección siguiente.

  1. En el directorio del proyecto, ejecute el siguiente comando para publicar el paquete definido en el archivo package.json en su feed:

    npm publish

Importante

No se admite el uso de la publishConfig propiedad para invalidar la configuración del Registro en el momento de la publicación.

Restaure paquetes desde su feed

Antes de restaurar los paquetes, asegúrese de autenticarse con su fuente de paquetes y actualizar los archivos .npmrc de su proyecto. Si aún no lo ha hecho, complete los pasos descritos en Conexión a una fuente y, a continuación, continúe.

  1. En el directorio del proyecto, ejecute el siguiente comando para restaurar todos los paquetes enumerados en el package.json archivo:

    npm install

  2. Para instalar un paquete específico desde el canal y añadirlo como dependencia en el archivo package.json, ejecute el siguiente comando:

    npm install --save <PACKAGE_NAME>

Contenido relacionado

  • Last updated on