Skip to content
Nubeteck Prime Docs
Blog

📦 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, luego dirígete a la configuración y haz clic en la pestaña de Aplicaciones: Tab applications

  2. En la sección Administrar Tokens de Acceso, dentro del apartado de “Generar nuevo token”, crea un token nuevo. Writing token name

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

    • Organization
    • Package
    • Repository

  4. 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. Token generated

  5. Después de obtener el token, debes crear un archivo llamado .npmrc en la raíz de tu proyecto cuando desees instalar paquetes desde el registro privado de Nubeteck.

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

    Terminal window
     @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

  7. No olvides cambiar la palabra TOKEN_HERE por el token generado.

  8. 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

Terminal window
@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 la empresa. De esta manera, puedes instalar paquetes tanto del registro de NPM como de nuestro registro privado.

Para instalar un paquete del registro privado

Terminal window
npm install @nubeteck/package-name@version


# Un ejemplo con una versión específica
npm install @nubeteck/package-name@1.0.0


# Un ejemplo con la última versión
npm install @nubeteck/package-name

Páginas para visitar