Gestionar su proyecto

Volta permite a equipos y colaboradores estandarizar las herramientas de desarrollo que usan para sus proyectos. Esta guía te mostrará cómo gestionar efectivamente tus proyectos con Volta.

Fijando Versiones de Herramientas

La característica más importante de gestión de proyectos en Volta es la capacidad de fijar versiones específicas de herramientas a tu proyecto:

Fijando Node.js

Para especificar qué versión de Node.js debe usar tu proyecto:

volta pin node@16.14.2

También puedes fijar a una versión mayor o menor, y Volta usará la última versión coincidente:

volta pin node@16

Fijando Gestores de Paquetes

De manera similar, puedes fijar versiones de npm y Yarn:

volta pin npm@8.5.0
volta pin yarn@1.22.18

Cómo Funciona la Fijación

Cuando fijas una versión de herramienta, Volta:

1. Actualiza el archivo package.json de tu proyecto con una sección volta
2. Confirma esta información al control de versiones
3. Asegura que todos en tu equipo usen las mismas versiones

Así es como se ve la sección volta en tu package.json:

{
  "name": "your-project",
  "version": "1.0.0",
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0",
    "yarn": "1.22.18"
  }
}

Herramientas Locales del Proyecto

Volta también respeta las instalaciones de herramientas locales del proyecto:

Usando Binarios de Paquetes Locales

Cuando instalas paquetes localmente en tu proyecto:

npm install typescript
# o
yarn add typescript

Puedes ejecutar sus binarios a través de Volta:

volta run tsc
# o simplemente
tsc

Volta usará la versión fijada de Node.js del proyecto para ejecutar estas herramientas.

Soporte de Espacios de Trabajo

Para configuraciones de monorepo con múltiples proyectos, Volta soporta herencia de configuración:

Extendiendo Configuraciones

En un espacio de trabajo con múltiples proyectos, puedes configurar una configuración base en el package.json raíz:

{
  "volta": {
    "node": "16.14.2",
    "yarn": "1.22.18"
  }
}

Luego en archivos package.json de proyectos individuales, extiende la configuración raíz:

{
  "volta": {
    "extends": "../../package.json"
  }
}

Esto te permite mantener versiones de herramientas consistentes a través de todos los proyectos en tu espacio de trabajo.

Mejores Prácticas para Gestión de Proyectos

Aquí hay algunas prácticas recomendadas para gestionar proyectos con Volta:

1. Siempre Fija Tus Herramientas

Fija las versiones de Node.js y gestor de paquetes para cada proyecto:

volta pin node
volta pin npm
# o
volta pin yarn

Esto asegura entornos de desarrollo consistentes para todos los miembros del equipo.

2. Confirma la Configuración de Volta

Siempre confirma la sección volta en tu package.json al control de versiones. Así es como Volta comparte configuración con tu equipo.

3. Documenta Requisitos de Herramientas

En el README de tu proyecto, menciona que usas Volta para gestión de herramientas:

## Desarrollo

Este proyecto usa [Volta](https://volta.sh) para asegurar herramientas consistentes.
Instala Volta, y las versiones correctas de Node.js y npm se usarán automáticamente.

4. Usa Integración CI/CD

En entornos de integración continua, instala Volta como parte de tu proceso de construcción:

# Ejemplo para GitHub Actions
- name: Install Volta
  uses: volta-cli/action@v1

# Volta usará automáticamente las versiones correctas de Node.js y npm/yarn
- name: Install dependencies
  run: npm install

5. Estandariza A Través de Proyectos

Para organizaciones con múltiples proyectos, estandariza en versiones de herramientas cuando sea posible para minimizar el número de versiones que los desarrolladores necesitan instalar.

Al gestionar efectivamente tus proyectos con Volta, aseguras que todos los miembros del equipo tengan entornos de desarrollo consistentes, reduciendo problemas de "funciona en mi máquina" y haciendo la colaboración más fluida.