📦 Configurar el registro privado de NPM

El registro de npm (Node Package Manager) es un repositorio en línea que almacena y gestiona paquetes de software destinados a la plataforma Node.js. Se trata de una base de datos centralizada que engloba una amplia variedad de paquetes de código abierto. Estos paquetes están disponibles para los desarrolladores y pueden ser incorporados en sus proyectos Node.js con el propósito de enriquecer sus funcionalidades y optimizar el proceso de desarrollo de software.

Registro privado de Nubeteck

Un repositorio privado de paquetes npm es un espacio destinado a alojar tus propios paquetes de código fuente, módulos y dependencias de npm, pero con acceso restringido. En este caso, solo los miembros de Nubeteck tienen la autorización para acceder. En lugar de compartir tus paquetes con la comunidad de desarrolladores a través del registro público de npm, puedes mantenerlos en privado y restringir el acceso únicamente a aquellos que poseen permisos específicos.

Autenticación con Token de Acceso

Para acceder a los paquetes privados de Nubeteck, tienes que generar un token de acceso en Gitea.

1. Accede a Gitea, da clic en tu foto de perfil que aparece en la esquina derecha superior luego dirígete a la configuración:

2. En la barra lateral izquierda, dentro de la sección de Configuración, dirígete a Aplicaciones:

3. En la sección Administrar Tokens de Acceso, dentro del apartado de llamado Generar nuevo token, rellena el formulario.

   Nombre del token

   Coloca un nombre al token de acceso que describa para qué será utilizado.

4. Luego despliega el apartado seleccionar permisos, debes seleccionar los que creas necesarios para el token a generar, normalmente se coloca lectura y escritura a:

   • Organization
   • Package
   • Repository

5. Da clic en Generar un nuevo token de acceso y automáticamente verás tu nuevo token de acceso en una alerta de color azul.

   No compartir

   Evita compartir o revelar este token de acceso a tus compañeros, ya que esto podría ocasionar problemas de seguridad en el futuro y perjudicarte.

6. Después de obtener el token (guárdalo bien ya que al reiniciar la pagina pierdes el token y debes volver hacer todo el proceso), debes crear un archivo llamado .npmrc en la raíz de tu proyecto cuando desees instalar paquetes desde el registro privado de Nubeteck.

7. Luego de crear el archivo .npmrc, debes copiar dentro del archivo las siguientes lineas:

    @nubeteck:registry=https://git.nubeteck.com/api/packages/nubeteck/npm/
    registry=https://registry.npmjs.org/
   
    //git.nubeteck.com/api/packages/nubeteck/npm/:_authToken=TOKEN_HERE
    //git.nubeteck.com/api/packages/npm/:_authToken=TOKEN_HERE

8. Cambia la palabra TOKEN_HERE por el token anteriormente generado.

9. Finalmente, guarda el archivo, y habrás configurado tanto el registro privado de Nubeteck como el registro público de NPM.

Explicación del registro privado

@nubeteck:registry=https://git.nubeteck.com/api/packages/nubeteck/npm/
registry=https://registry.npmjs.org/

• El prefijo @nubeteck se utiliza para especificar el alcance (scope) de los paquetes que deseas instalar.
• registry= hace referencia a una variable que contiene la URL del registro privado.

La razón por la que existen dos referencias al “registry” es para permitir el acceso tanto al registro público de npm como a los paquetes privados de Nubeteck. De esta manera, puedes instalar paquetes tanto del registro de NPM como de nuestro registro privado.

Para instalar un paquete del registro privado

# Comando básico para instalar un paquete privado
npm install @nubeteck/package-name@version

# Un ejemplo con una versión específica
npm install @nubeteck/utils@0.12.0

# Un ejemplo con la última versión
npm install @nubeteck/utils

Páginas para visitar

• Gitea Packages Repository (NPM)
• NPM Registry Official