Introducción a los paquetes npm en Azure Artifacts

Artículo
11/29/2021
Tiempo de lectura: 5 minutos

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 propiedad para invalidar el parám de configuración publishConfig del Registro en tiempo de publicación.

Restaurar paquetes

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

npm install --save <package>

Pasos siguientes

Publicar paquetes npm (YAML/clásico)Usepackages from npmjs.comUsenpm scopes Use npm audit

Con Azure Artifacts, puede publicar y descargar paquetes npm desde fuentes y registros públicos, como npmjs.com. Esta guía de inicio rápido le guiará a través de la creación de su propia fuente, la configuración del proyecto y la publicación y descarga de paquetes npm hacia y desde la Azure Artifacts fuente.

Licencia de la Azure Artifacts extensión

Para usar Azure Artifacts en TFS, debe actualizar a Visual Studio Team Foundation Server 2017. Si se ha Azure Artifacts extensión, puede instalarla desde Visual Studio Marketplace.

Asignación de licencias en Team Foundation Server

Cada organización obtiene cinco licencias gratuitas. Si necesita más de cinco licencias, vaya a Visual Studio Marketplacey seleccione Obtener gratis.

Si no está seguro, puede seleccionar Start 30-day free trial(Iniciar evaluación gratuita de 30 días). A cada usuario de su organización se le concede acceso a Azure Artifacts durante 30 días. Después del período de prueba de 30 días, la organización vuelve a cinco usuarios autorizados y debe asignar licencias a usuarios individuales. Si necesita licencias adicionales en este momento, puede comprarlas en Visual Studio Marketplace. Si tiene una licencia para Visual Studio Enterprise, ya tiene acceso a Azure Artifacts y no es necesario que se le asigne una licencia. Solo tiene que asegurarse de que se le ha asignado el nivel de acceso "Visual Studio Enterprise".

Nota

Si seleccionó Start 30 day free trial (Iniciar evaluación gratuita de 30 días) y todavía está en el período de prueba, se concederá acceso a todos los usuarios. No es necesario asignar licencias hasta que finalice el período de prueba.

En cualquier colección de Team Foundation Server, mantenga el puntero sobre el menú de configuración y seleccione Usuarios. A continuación, seleccione Administración de paquetes.
Seleccione Asignar, escriba los usuarios a los que desea asignar licencias y, a continuación, seleccione Aceptar.
- Los usuarios con Visual Studio Enterprise suscripciones pueden Azure Artifacts gratis. Asegúrese de que los suscriptores Visual Studio Enterprise tienen el nivel de acceso adecuado. Para obtener más información, vea Cambiar los niveles de acceso.
- Los usuarios que usan una instancia de Team Foundation Server que está desconectada de Internet (y, por tanto, no pueden comprar licencias de Visual Studio Marketplace) todavía pueden asignar licencias adquiridas a través de un contrato Enterprise.

Creación de una fuente

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 admiten el almacenamiento de varios tipos de paquetes en una sola fuente, como NuGet, npm, Maven, Python y paquetes universales.

Desde dentro del proyecto, vaya a Azure Artifacts.
Seleccione Crear fuente.
Asigne un nombre a la fuente y elija su visibilidad,orígenes ascendentesy configuración de ámbito.
Seleccione Crear cuando haya terminado.

Azure Artifacts está instalado de forma predeterminada para los clientes de TFS 2017. Debe actualizar a TFS 2017 para poder usar Azure Artifacts. Si es la primera vez que usa la fuente, es posible que se le pida que asigne una licencia.

Vaya a Build Release (Versión de compilación) y seleccione Packages (Paquetes).
Seleccione + Nueva fuente.
Asigne a la fuente un nombre,una descripcióny configure quién puede leer , quién puede contribuir y si desea incluir paquetes externos.
Seleccione Crear cuando haya terminado.

Puede cambiar esta configuración más adelante editando la configuración de la fuente.

Captura de pantalla del botón Editar fuente.

Captura de pantalla del botón Editar fuente TFS.

Configuración de los archivos .npmrc

Nota

vsts-npm-authno se admite en TFS ni Azure DevOps Server.

Se recomienda tener dos archivos .npmrc. El primero debe colocarse 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 las credenciales. A continuación, el cliente npm podrá buscar este archivo y capturar sus credenciales para la autenticación. Esto le permite compartir el archivo de configuración mientras mantiene sus credenciales seguras.

Seleccione Artifactsy, a continuación, seleccione Conectar para alimentar.
Seleccione npm. Si es la primera vez que usa Azure Artifacts, seleccione Obtener las herramientas y, a continuación, siga los pasos para descargar Node.js y configurar el proveedor de credenciales.
Siga las instrucciones de la Project configuración para configurar el proyecto.

Configuración de la autenticación en la máquina de desarrollo

Importante

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

Windows
Linux/MacOS

Si va a desarrollar en Windows, se recomienda usar vsts-npm-auth para autenticarse con Azure Artifacts. Ejecute npm install -g vsts-npm-auth para instalar el paquete globalmente y, a continuación, agregue un script de ejecución a package.json.

"scripts": {
    "refreshVSToken": "vsts-npm-auth -config .npmrc"
}

vsts-npm-auth no se admite en Linux o MacOS. Para autenticarse con Azure Artifacts, tenemos que crear un token de acceso personal y agregarlo a nuestro archivo .npmrc.

Copie el siguiente fragmento de código en el archivo .npmrc.

Fuente con ámbito de 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

Project de ámbito de aplicación:

; 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

Genere un token de acceso personal conámbitos de lectura y escritura de empaquetado.
Codifica 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 con privilegios elevados.
```
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 valor codificado en Base64.
Reemplace el [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] marcador de posición del archivo .npmrc por el token de acceso personal de Base64.

Seleccione Paquetesy, a continuación, Conectar para alimentar.
Seleccione npm.
Seleccione Generate npm credentials (Generar credenciales de npm). Copie las credenciales y agrégrélas al archivo .npmrc.