Uso de paquetes del registro de npm

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

Los orígenes ascendentes de Azure Artifacts permiten a los desarrolladores consumir paquetes de registros públicos como npmjs.com. Una vez que las fuentes ascendentes estén habilitadas en tu feed, Azure Artifacts guarda automáticamente una copia de cualquier paquete instalado desde una fuente ascendente en tu feed. Esta configuración ofrece la mayor flexibilidad, ya que te permite utilizar una combinación de paquetes con y sin ámbito, incluidos los de registros públicos, todo ello dentro de un único feed. Esta configuración también garantiza el acceso continuo a esos paquetes incluso si el origen ascendente deja de estar disponible temporalmente.

Requisitos previos

Obtención de las herramientas

Si esta es la primera vez que usa Azure Artifacts con npm en la máquina, siga los pasos que se indican a continuación para configurar el entorno:

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

Crear una fuente

Si ya tiene un feed de Azure Artifacts, vaya a la sección siguiente. De lo contrario, cree uno nuevo de la siguiente manera:

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

2. Seleccione Artefactos y, después, Crear Feed.

3. Escriba un Nombre para su feed, establezca la Visibilidad para definir quién puede ver sus paquetes, y elija el Alcance del feed. Asegúrese de activar la casilla Incluir paquetes de orígenes públicos comunes para habilitar orígenes ascendentes y permitir el consumo de paquetes de registros públicos.

4. Seleccione Crear cuando haya terminado.

Agregar npmjs como repositorio ascendente

Si ha activado la casilla de verificación de fuentes ascendentes durante la creación de su feed, npmjs se agregará automáticamente a la lista de fuentes ascendentes de su feed. Si no es así, puede agregarlo manualmente de la siguiente manera:

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

2. Seleccione Artefactos y, a continuación, seleccione tu feed en el menú desplegable.

3. Seleccione el botón con el icono de engranaje para abrir Configuración del feed.

4. Seleccione Fuentes ascendentes y, después, Agregar fuente ascendente.

5. Seleccione Origen público y, después, npmjs (https://registry.npmjs.org/) en el menú desplegable.

6. Seleccione Agregar cuando haya terminado.

7. Seleccione Guardar en la esquina superior derecha para aplicar los cambios.

Conexión a una fuente

Antes de poder empezar a guardar paquetes de fuentes upstream en tu feed, debes configurar primero tu proyecto y conectarte a tu feed.

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

2. Seleccione Artefactos y, a continuación, seleccione tu feed en el menú desplegable.

3. Seleccione Conectar al Feed y, a continuación, seleccione npm desde el panel izquierdo.

4. Sigue los pasos de la sección Configuración del proyecto para configurar tu archivo .npmrc y autenticarte en tu feed. Consulte Configuración del proyecto de npm para obtener más información.

Instalación de paquetes desde npmjs

Ahora que te has autenticado en tu feed, puedes empezar a instalar paquetes desde registros públicos como npmjs.com. Cuando instalas un paquete desde una fuente ascendente, Azure Artifacts guarda automáticamente una copia de ese paquete en tu feed. En este ejemplo, instalará Mongoose, una biblioteca de Modelado de datos de objetos de MongoDB (ODM) que ayuda con la definición de esquemas, la validación de datos y el modelado de objetos en Node.js aplicaciones.

1. Ir a https://www.npmjs.com.

2. Busque el paquete de Mongoose y selecciónelo para ir a su página de detalles.

3. Copie el comando de instalación en su portapapeles.

4. En una ventana del terminal de comandos, vaya al directorio de su proyecto y ejecute el comando de instalación.

   npm i mongoose
   

Visualización de paquetes guardados

Ahora que has instalado un paquete desde el registro de npm, puedes ver cómo Azure Artifacts guarda automáticamente una copia de ese paquete en tu feed. Siga estos pasos para confirmar que el paquete se agregó a tu feed:

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

2. Seleccione Artefactos y, a continuación, seleccione tu feed en el menú desplegable.

3. En el menú Origen de la esquina superior derecha, seleccione npmjs para filtrar los paquetes desde el registro de npm.

4. El paquete mongoose que instaló en el paso anterior debería aparecer ahora en su feed de datos. Azure Artifacts guardó una copia automáticamente cuando ejecutó el comando de instalación.

   

Contenido relacionado

• publicar paquetes npm (CLI)

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

• Ámbitos de Npm