Trabajar con paquetes de Node.js

Artifact Registry admite paquetes de Node.js que administras con la Administración de socios de red.

La administración de paquetes se encuentra en versión Alfa. Solo está disponible para los usuarios Alfa y es posible que no incluya todas las funciones disponibles para la administración de contenedores. Si deseas postularte para la versión Alfa, completa el formulario de registro. Si quieres obtener más información, consulta Requisitos para acceder a las funciones Alfa.

Descripción general

Para familiarizarte con los paquetes de Node.js en Artifact Registry, puedes probar la guía de inicio rápido.

Cuando estés listo para obtener más información, lee lo siguiente:

  1. Si eres nuevo en la Administración de socios de red, lee acerca de los siguientes conceptos:
  2. Crea un repositorio de la Administración de socios de red para tus paquetes.
  3. Otorga permisos a la cuenta que se conectará con el repositorio. Las cuentas de servicio para las integraciones comunes con Artifact Registry tienen permisos predeterminados en los repositorios del mismo proyecto.
  4. Configura la Administración de socios de red para realizar la autenticación en el repositorio.
  5. Obtén más información sobre cómo administrar paquetes

Usa permisos

Un permiso de la Administración de socios de red es una etiqueta para agrupar paquetes. Los permisos son necesarios cuando trabajas con varios registros de la Administración de socios de red, incluidos los siguientes:

  • Publicar e instalar paquetes en diferentes registros sin la necesidad de cambiar de un registro a otro. Por ejemplo, tus compilaciones pueden incluir paquetes tanto del registro de npm públicos como de un repositorio de Artifact Registry.
  • Publicar los mismos paquetes en varios repositorios de Artifact Registry en proyectos de Google Cloud, así como otros registros de la Administración de socios de red, sin que se generen conflictos de nombres de paquetes.

Te recomendamos que siempre establezcas un permiso para tus repositorios. Si no especificas un permiso cuando publicas o instalas un paquete, la Administración de socios de red usará el registro predeterminado configurado, como el registro público de la Administración de socios de red.

Establece el permiso de cada repositorio de Artifact Registry en el archivo de configuración .npmrc. Las mismas credenciales para la autenticación se aplican a los repositorios.

En el siguiente ejemplo, se muestra la configuración de dos repositorios de Artifact Registry en diferentes proyectos.

  • El permiso @blue es para el repositorio del proyecto blue-project.
  • El permiso @green es para el repositorio del proyecto green-project.
@blue:registry=https://us-central1-npm.pkg.dev/blue-project/blue-npm-repo/
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/blue-project/blue-npm-repo/:always-auth=true

@green:registry=https://us-central1-npm.pkg.dev/green-project/green-npm-repo/
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:_authToken=""
//us-central1-npm.pkg.dev/green-project/green-npm-repo/:always-auth=true

Después de autenticarte en Artifact Registry, puedes subir un paquete a un repositorio en particular mediante el permiso adecuado. Por ejemplo, mediante el siguiente comando, se sube un paquete a blue-npm-repo en el proyecto blue-project:

npm publish @blue/blue-npm-repo

Para obtener más información sobre los permisos, consulta la documentación de la Administración de socios de red.

Cómo almacenar las credenciales

La configuración que se usa para la autenticación se almacena en los archivos de configuración de la Administración de socios de red. Estos archivos se denominan .npmrc. La siguiente configuración se usa para Artifact Registry.

  • Credenciales del registro público de la Administración de socios de red

    Almacena tus credenciales para el registro público de la Administración de socios de red (https://registry.npmjs.org/) en el archivo de configuración por usuario, de forma que no estén disponibles para otros usuarios. Este archivo se encuentra en el directorio principal de tu usuario o se establece con el parámetro --userconfig de la Administración de socios de red o la variable de entorno $NPM_CONFIG_USERCONFIG. Las herramientas de Artifact Registry para la autenticación con repositorios de Artifact Registry se encuentran en el registro público de la Administración de socios de red.

  • Configuración para conectarse a repositorios de Artifact Registry

    Puedes almacenar la configuración del repositorio de Artifact Registry en uno de estos archivos de configuración de la Administración de socios de red:

    • El archivo de configuración por proyecto. Este archivo .npmrc suele estar en el mismo directorio que el archivo package.json en tu proyecto de la Administración de socios de red. Esta es la opción más simple.

    • El archivo de configuración por usuario Este archivo se encuentra en el directorio principal del usuario o se establece con el parámetro --userconfig de npm o la variable de entorno $NPM_CONFIG_USERCONFIG.

    • El archivo de configuración global, $PREFIX/etc/npmrc. Para obtener el valor de $PREFIX, ejecuta el comando npm prefix -g.

Debes conservar cualquier registro predeterminado existente que esté configurado en tu archivo npmrc. Por lo general, se establece de forma predeterminada en el registro público de la Administración de socios de red en https://registry.npmjs.org/.

Para comprobar el valor de registro predeterminado actual, ejecuta el siguiente comando:

npm get registry

Para obtener más información sobre los archivos de configuración de la Administración de socios de red, consulta la documentación sobre el archivo de configuración de la Administración de socios de red.