volta pin

El comando volta pin actualizará el archivo package.json de un proyecto para usar la versión seleccionada de una herramienta. Tiene la siguiente sintaxis:

Fija el tiempo de ejecución o gestor de paquetes de tu proyecto

USO:
    volta pin [FLAGS] <tool[@version]>...

FLAGS:
        --verbose    Habilita diagnósticos verbosos
        --quiet      Previene salida innecesaria
    -h, --help       Imprime información de ayuda

ARGS:
    <tool[@version]>...    Herramientas a fijar, como `node@lts` o `yarn@^1.14`.

Notavolta pin solo funciona con Node y Gestores de Paquetes (ej. npm o Yarn). Para dependencias, deberías usar npm install o yarn add para actualizar las versiones seleccionadas.

Ejemplos

Fijando Node.js

# Fijar la última versión LTS de Node
volta pin node

# Fijar una versión específica de Node
volta pin node@16.14.2

# Fijar un rango de versión de Node
volta pin node@16

Cuando fijas una versión de Node.js, Volta añade una sección volta al archivo package.json de tu proyecto:

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

Fijando Gestores de Paquetes

# Fijar la última versión de npm
volta pin npm

# Fijar una versión específica de Yarn
volta pin yarn@1.22.19

# Fijar pnpm (si la bandera de característica está habilitada)
VOLTA_FEATURE_PNPM=1 volta pin pnpm@7.0.0

Fijar gestores de paquetes los añade a la sección volta en tu package.json:

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

Casos de Uso

El comando volta pin es esencial para:

• Crear entornos de desarrollo consistentes a través de tu equipo
• Asegurar que todos trabajando en un proyecto usen la misma versión de Node.js y gestor de paquetes
• Prevenir problemas de "funciona en mi máquina"
• Documentar con qué versión de Node.js tu proyecto es compatible

Efectos de Fijar

Cuando fijas una herramienta:

1. La herramienta se instala automáticamente si no la tienes ya
2. La versión se escribe a package.json en la sección volta
3. Cualquiera con Volta que trabaje en el proyecto usará automáticamente la versión especificada
4. Los sistemas CI/CD usando Volta usarán la versión correcta

Las herramientas fijadas toman precedencia sobre las versiones por defecto de herramientas establecidas con volta install.

Detalles de Package.json

La sección volta en package.json puede incluir:

{
  "volta": {
    "node": "16.14.2",    // Versión exacta
    "npm": "^8.5.0",      // Rango semver
    "yarn": "1.22.19",    // Versión exacta
    "pnpm": "7.0.0"       // Si el soporte de pnpm está habilitado
  }
}

Los especificadores de versión pueden ser:

• Versiones exactas: 16.14.2
• Versiones mayores: 16
• Versiones mayor.menor: 16.14
• Rangos semver: ^16.14.0
• Etiquetas: lts, latest