Управление вашим проектом

Volta позволяет командам и соавторам стандартизировать инструменты разработки, которые они используют для проектов. Это руководство покажет вам, как эффективно управлять вашими проектами с помощью Volta.

Закрепление версий инструментов

Самая важная функция управления проектами в Volta - это возможность закреплять конкретные версии инструментов за вашим проектом:

Закрепление Node.js

Чтобы указать, какую версию Node.js должен использовать ваш проект:

volta pin node@16.14.2

Вы также можете закрепить основную или младшую версию, и Volta будет использовать последнюю соответствующую версию:

volta pin node@16

Закрепление пакетных менеджеров

Аналогично, вы можете закреплять версии npm и Yarn:

volta pin npm@8.5.0
volta pin yarn@1.22.18

Как работает закрепление

Когда вы закрепляете версии инструментов, Volta:

1. Обновляет файл package.json вашего проекта секцией volta
2. Фиксирует эту информацию в системе контроля версий
3. Обеспечивает использование одинаковых версий всеми в команде

Вот как выглядит секция volta в вашем package.json:

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

Локальные инструменты проекта

Volta также учитывает локальные установки инструментов проекта:

Использование локальных исполняемых файлов пакетов

Когда вы устанавливаете пакеты локально в ваш проект:

npm install typescript
# или
yarn add typescript

Вы можете запускать их исполняемые файлы через Volta:

volta run tsc
# или просто
tsc

Volta будет использовать закреплённую версию Node.js проекта для запуска этих инструментов.

Поддержка рабочих пространств

Для настроек monorepo с несколькими проектами Volta поддерживает наследование конфигурации:

Расширение конфигурации

В рабочем пространстве с несколькими проектами вы можете установить базовую конфигурацию в корневом package.json:

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

Затем в отдельных файлах package.json проектов расширьте корневую конфигурацию:

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

Это позволяет поддерживать согласованные версии инструментов во всех проектах в вашем рабочем пространстве.

Лучшие практики управления проектами

Вот некоторые рекомендуемые практики для управления проектами с помощью Volta:

1. Всегда закрепляйте ваши инструменты

Закрепляйте версии Node.js и пакетного менеджера для каждого проекта:

volta pin node
volta pin npm
# или
volta pin yarn

Это обеспечивает согласованную среду разработки для всех участников команды.

2. Фиксируйте конфигурацию Volta

Всегда фиксируйте секцию volta в package.json в системе контроля версий. Это то, как Volta делится конфигурацией с вашей командой.

3. Документируйте требования к инструментам

В README вашего проекта упомяните, что вы используете Volta для управления инструментами:

## Разработка

Этот проект использует [Volta](https://volta.sh) для обеспечения согласованности инструментов.
Установите Volta, и правильные версии Node.js и npm будут использоваться автоматически.

4. Используйте интеграцию CI/CD

В средах непрерывной интеграции включите установку Volta как часть процесса сборки:

# Пример GitHub Actions
- name: Install Volta
  uses: volta-cli/action@v1

# Volta автоматически будет использовать правильные версии Node.js и npm/yarn
- name: Install dependencies
  run: npm install

5. Стандартизируйте между проектами

Для организаций с несколькими проектами старайтесь стандартизировать версии инструментов, где это возможно, чтобы минимизировать количество версий, которые разработчики должны установить.

Эффективно управляя вашими проектами с помощью Volta, вы обеспечиваете согласованную среду разработки для всех участников команды, уменьшаете проблемы "работает на моей машине" и делаете сотрудничество более гладким.