Administra paquetes de Node.js

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

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 npm, lee sobre los siguientes conceptos:
  2. Crea un repositorio de paquetes de Node.js para tus paquetes.
  3. Otorga permisos a la cuenta que se conectará con el repositorio. Cuentas de servicio para integraciones comunes con Artifact Registry tienen permisos predeterminados para repositorios en el mismo proyecto.
  4. Configura tus herramientas:
  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 del registro público de npm y de Artifact Registry en un repositorio de confianza.
  • 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/: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.

Configura npm

La configuración que se usa para la autenticación se almacena en el archivo de configuración .npmrc. Puedes configurar un archivo .npmrc a nivel del proyecto, del usuario o global.

Cuando configuras la autenticación con Artifact Registry, defines los repositorios a los que quieres conectarte y las credenciales para autenticación.

Repositorios de Artifact Registry

Te recomendamos configurar la lista de repositorios en el archivo de configuración por proyecto. Este archivo suele estar en el mismo directorio que el archivo package.json en tu proyecto de npm. El auxiliar de credenciales de Artifact Registry verifica este archivo .npmrc de tus repositorios de forma predeterminada.

Si no quieres exponer las rutas del repositorio en tu control de código fuente de red, puedes hacer lo siguiente:

  • Agrega el nombre de archivo .npmrc a la lista de archivos que se deben ignorar del control de código fuente.
  • En su lugar, almacena la lista de repositorios en tu archivo de configuración por usuario. El archivo .npmrc por usuario 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. La configuración del archivo de configuración por usuario se aplica a todos tus proyectos, a menos que los anules a nivel del proyecto.
Credenciales de Artifact Registry

Almacena tus credenciales para Artifact Registry en la configuración por usuario. para 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.

Artifact Registry el auxiliar de credenciales se almacena en el registro público de npm y no requiere autenticación para la instalación.

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 verificar el valor predeterminado actual del registro, ejecuta el comando:

npm get registry

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