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:
- Si eres nuevo en npm, lee sobre los siguientes conceptos:
- Crea un repositorio de paquetes de Node.js para tus paquetes.
- 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.
- Configura tus herramientas:
- Configura la autenticación para npm.
- Configura Cloud Build para subir y descargar paquetes.
- Obtén información para implementar en entornos de ejecución de Google Cloud.
- 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 proyectoblue-project
. - El permiso
@green
es para el repositorio del proyectogreen-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.
- Agrega el nombre de archivo
- 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.