Skip to content

Fijar versiones de Node

Una de las características más poderosas de Volta es la capacidad de fijar versiones específicas de herramientas a tu proyecto, asegurando que todos trabajando en el proyecto usen exactamente la misma cadena de herramientas.

¿Por Qué Fijar Versiones?

  • Consistencia: Todos en tu equipo usan las mismas versiones
  • Reproducibilidad: Los entornos de construcción coinciden con los entornos de desarrollo
  • Confiabilidad: Sin sorpresas del comportamiento inesperado de herramientas
  • Incorporación: Los nuevos miembros del equipo obtienen automáticamente la configuración correcta

Cómo Fijar Node.js

Para fijar una versión específica de Node.js a tu proyecto:

bash
volta pin node@16.14.2

Este comando:

  1. Descarga e instala Node.js 16.14.2 (si no está presente ya)
  2. Actualiza tu package.json con una sección volta
  3. Hace que el proyecto use Node.js 16.14.2 cuando ejecutes node en el directorio del proyecto

Tu package.json ahora contendrá:

json
{
  "volta": {
    "node": "16.14.2"
  }
}

Fijando Gestores de Paquetes

También puedes fijar versiones específicas de gestores de paquetes:

bash
volta pin npm@8.5.0
volta pin yarn@1.22.18
volta pin pnpm@7.0.0

Esto asegura que todos usen la misma versión de gestor de paquetes, previniendo inconsistencias de archivos de bloqueo y otros problemas de versionado.

Después de fijar npm, tu package.json se verá así:

json
{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  }
}

Usando Herramientas Fijadas

Una vez que las herramientas están fijadas, no se necesitan comandos adicionales. Simplemente navega al directorio de tu proyecto y ejecuta comandos normalmente:

bash
# Estos usarán las versiones fijadas de tu proyecto
node --version
npm --version

Volta detecta automáticamente cuando estás en un directorio con versiones fijadas y las usa en lugar de tus herramientas por defecto.

Actualizando Versiones Fijadas

Para actualizar una versión fijada:

bash
volta pin node@latest
volta pin npm@latest

O especifica una nueva versión:

bash
volta pin node@18

Mejores Prácticas

Cuándo Fijar

  • Para aplicaciones de producción: Siempre fija tanto Node como tu gestor de paquetes
  • Para librerías/paquetes: Fija Node si tu código depende de características específicas de Node
  • Para herramientas/utilidades: Fija la versión mínima de Node requerida para funcionalidad

Selección de Versión

  • Para aplicaciones, elige una versión LTS (Soporte a Largo Plazo) de Node
  • Para librerías, usa la versión más antigua de Node que quieras soportar
  • Actualiza versiones periódicamente para beneficiarte de correcciones de seguridad

Integración CI/CD

Asegúrate de que tus pipelines CI/CD respeten tus versiones fijadas:

  • Usa la Acción GitHub de Volta en flujos de trabajo de GitHub
  • Para otros sistemas CI, instala Volta y automáticamente usará tus versiones fijadas