Compartir a través de

Introducción a los paquetes de npm en Azure Artifacts

  • Artículo

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

Con Azure Artifacts, puede publicar y descargar los paquetes de npm desde fuentes y registros públicos, como npmjs.com. Este inicio rápido le guiará a través de la creación de la fuente, la configuración del proyecto y la administración de paquetes npm con la fuente de Azure Artifacts.

Requisitos previos

Crear feed

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

  2. Seleccione Artefactos y, a continuación, seleccione Crear fuente para crear una nueva fuente.

  3. Escriba un nombre descriptivo para la fuente y defina su visibilidad (que indica quién puede ver los paquetes dentro de la fuente). Especifique el ámbito de la fuente y, si desea incluir paquetes de orígenes públicos, marque la casilla Orígenes ascendentes .

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra cómo 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, seleccione Crear fuente para crear una nueva fuente.

  3. Escriba un nombre descriptivo para la fuente y defina su visibilidad (que indica quién puede ver los paquetes dentro de la fuente). Especifique el ámbito de la fuente y, si desea incluir paquetes de orígenes públicos, marque la casilla Orígenes ascendentes .

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra cómo crear una nueva fuente en Azure DevOps 2022.

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra cómo crear una nueva fuente en Azure DevOps 2020.

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

  2. Seleccione Artefactos y, a continuación, seleccione Nueva fuente.

  3. Escriba un nombre descriptivo para la fuente y defina su visibilidad (que indica quién puede ver los paquetes dentro de la fuente). Si desea incluir paquetes de orígenes públicos, seleccione la opción Usar paquetes de orígenes públicos a través de esta fuente .

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra cómo crear una nueva fuente en Azure DevOps 2019.

Nota:

De forma predeterminada, las fuentes recién creadas tienen el servicio de compilación de su proyecto establecido en Fuente y Lector ascendente (Colaborador).

Conectar a una fuente

Nota:

vsts-npm-auth no se admite en Azure DevOps Server.

Azure Artifacts recomienda usar dos archivos .npmrc. La primera debe colocarse en el directorio $home (Linux/macOS) o $env. HOME (Windows) para almacenar de forma segura sus credenciales. Esto permite al cliente npm localizar el archivo y recuperar las credenciales para la autenticación, lo que le permite compartir el archivo de configuración sin exponer las credenciales. En esta sección, configuraremos el segundo archivo .npmrc , que debe colocarse en el mismo directorio que el archivo package.json .

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

  2. Seleccione Artefactos y, a continuación, seleccione Conectar para alimentar.

  3. Seleccione npm en el área de navegación izquierda. Si es la primera vez que usa Azure Artifacts con npm, asegúrese de que ha instalado los requisitos previos.

  4. Siga las instrucciones de la sección Configuración del proyecto para configurar el archivo de configuración y conectarse a la fuente.

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

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

  2. Seleccione Artefactos y, a continuación, seleccione Conectar a Fuente.

  3. Seleccione npm de la izquierda y siga las instrucciones de la sección Configuración del proyecto para conectarse a la fuente.

    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.

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

  2. Seleccione Artefactos y, a continuación, seleccione Conectar para alimentar.

  3. Seleccione npm de la izquierda y siga las instrucciones de Configuración del proyecto para configurar el archivo de configuración y conectarse a la fuente.

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

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

  2. Seleccione Artefactos y, a continuación, seleccione Conectar para alimentar.

  3. Aparecerá una ventana nueva. En el panel de navegación izquierdo, seleccione npm y siga las instrucciones para configurar el proyecto y los archivos user.npmrc.

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

Importante

npm admite un único registry en el archivo .npmrc. Se pueden realizar varios registros con ámbitos y orígenes ascendentes.

Publicar paquetes

Ejecute el siguiente comando en el directorio del proyecto para publicar los paquetes de npm:

npm publish

Importante

No se admite el uso de la publishConfig propiedad para invalidar el parámetro de configuración del Registro en tiempo de publicación.

Restaurar paquetes

Ejecute el siguiente comando en el directorio del proyecto para restaurar los paquetes de npm:

npm install

Para restaurar un paquete npm específico, ejecute el siguiente comando desde el directorio del proyecto:

npm install --save <PACKAGE_NAME>