Introducción a los paquetes de npm en Azure Artifacts

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

Con Azure Artifacts, puede publicar y descargar paquetes npm desde fuentes y registros públicos, como npmjs.com. Este inicio rápido le guiará por el proceso de creación de la fuente, la configuración del proyecto y la publicación y descarga de paquetes npm hacia y desde la fuente de Azure Artifacts.

Crear feed

Una fuente es una construcción organizativa que permite a los usuarios almacenar sus paquetes y controlar quién puede acceder a ellos. Azure Artifacts admite el almacenamiento de varios tipos de paquetes en una sola fuente, como NuGet, npm, Maven, Python, Cargo y paquetes universales.

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.

   

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).

Configurar los archivos .npmrc

Nota:

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

Se recomienda usar dos archivos .npmrc. La primera debe encontrarse en el mismo directorio que el archivo package.json. El segundo debe colocarse en el directorio $home (Linux/macOS) o $env. HOME (Windows) para almacenar de forma segura sus credenciales. Después, el cliente npm podrá buscar este archivo y capturar sus credenciales para la autenticación. Esto le permite compartir el archivo de configuración al tiempo que mantiene las credenciales seguras.

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 panel de navegación izquierdo. Si es la primera vez que usa Azure Artifacts con npm, seleccione Obtener las herramientas y siga los pasos para descargar Node.js y configurar la máquina.

4. Inserte el siguiente fragmento de código en el archivo .npmrc, el que se encuentra en el mismo directorio que el archivo package.json. Reemplace los marcadores de posición por los valores devueltos adecuados.

   • Fuente con ámbito de la organización:

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

   • Fuente con ámbito de proyecto:

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

Credenciales de instalación

Importante

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

Windows

Si está desarrollando en Windows, se recomienda usar vsts-npm-auth para autenticarse con Azure Artifacts. Asegúrese de que tiene vsts-npm-auth instalado desde Obtener las herramientas y, a continuación, ejecute vsts-npm-auth para obtener un token de Azure Artifacts agregado al archivo npmrc de nivel de usuario:

vsts-npm-auth -config .npmrc

Otros

Si está desarrollando en una plataforma que no es de Windows y necesita autenticarse con Azure Artifacts, debe crear un token de acceso personal, codificarlo en Base 64 y, a continuación, agregarlo al archivo npmrc de nivel de usuario.

1. Genere un token de acceso personal con ámbitos de lectura y escritura empaquetados.

2. Codifique el token de acceso personal recién generado de la siguiente manera:

   1. Ejecute el siguiente comando en una ventana del símbolo del sistema para codificar el PAT:

      node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
      

   2. Pegue el token de acceso personal y presione Entrar.

   3. Copie el token de acceso personal codificado en Base 64.

3. Copie el siguiente fragmento de código en el archivo .npmrc de nivel de usuario y reemplace el marcador de posición por el [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] token de acceso personal de Base 64:

   • Fuente con ámbito de la organización:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • Fuente con ámbito de proyecto:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

---

Publicar paquetes

Para publicar el paquete npm, ejecute el siguiente comando en el directorio del proyecto:

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

Para restaurar un paquete de npm, ejecute el siguiente comando en el directorio del proyecto:

npm install --save <package>

Para restaurar todos los paquetes de npm, ejecute el siguiente comando desde el directorio del proyecto:

npm install

Artículos relacionados

• Publicación de paquetes npm (YAML/clásico)
• Uso de paquetes de npmjs.com
• Uso de ámbitos de npm