Saltar al contenido principal

Gestión del Runtime: Node.js

En arquitecturas de ingeniería modernas, la gestión del runtime de Node.js debe estar desacoplada de los repositorios del sistema operativo. Esto previene conflictos de permisos (EACCES) y permite la paridad de entornos entre desarrollo y producción.

Este estándar define el uso de Node Version Manager (NVM) sobre estaciones de trabajo basadas en Debian 13 (Trixie) con escritorio KDE Plasma (Q4OS).

Visión de Arquitectura

El uso de NVM garantiza que los paquetes globales instalados vía npm install -g residan en el espacio de usuario ($HOME), eliminando la necesidad de sudo y preservando la integridad de las rutas protegidas del sistema.

1. Protocolo de Instalación de NVM​

El despliegue de NVM es el primer paso crítico para habilitar el ecosistema de desarrollo (Docusaurus/Astro).

  1. Inyección del Script de Gestión: Descargue y ejecute el instalador oficial en el perfil del usuario.
    Terminal
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
  1. Persistencia de Variables de Entorno: Asegure que la shell reconozca el binario añadiendo estas directivas al final de su ~/.bashrc: 
    export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && echo "$HOME/.nvm" || echo "$XDG_CONFIG_HOME/nvm")"
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
  1. Refresco de Sesión: 
    source ~/.bashrc

2. Estrategia de Versiones (LTS)​

Para garantizar la estabilidad en la compilación de este sitio (dz.log) y herramientas Big Data, utilizaremos exclusivamente ramas LTS (Long Term Support).

# Instalar última versión estable
nvm install --lts

# Definir como persistente
nvm alias default 'lts/*'

3. Integración con el Proyecto DZ.LOG​

Para evitar discrepancias en el despliegue de este repositorio, implementamos un Contrato de Versión mediante archivos .nvmrc.

Práctica de Ingeniería Senior

Siempre que trabaje en el directorio ~/hot-tier/pascual-zamo.gitlab.io, valide el runtime. Al entrar en la carpeta, ejecute nvm use para sincronizarse con la versión declarada en el proyecto.

Procedimiento para declarar la versión del proyecto:

Estableciendo el contrato
node -v > .nvmrc # Captura la versión actual (ej: v22.13.0)

4. Diagnóstico y Troubleshooting​

Error ComúnCausa RaízAcción Correctiva
EACCESNode instalado vía APTDesinstalar Node de APT e instalar vía NVM
command not found: nvmBash no inicializadoValidar carga en ~/.bashrc y ejecutar source
GLIBC not foundDesajuste de KernelValidar Debian 13 / Kernel 6.x+

Flujo Lógico de Inicialización​

Documentación Relacionada: