Установка Yarn на Ubuntu 22.04

Yarn — менеджер пакетов для экосистемы JavaScript. Это альтернатива npm, разработанная командой Facebook в сотрудничестве с Google, Tilde и Expo Dev. Yarn ускоряет установку пакетов за счёт локального кэша и решает ряд проблем с безопасностью и производительностью в больших кодовых базах.

В этом руководстве описано, как установить Yarn на сервер с Ubuntu 22.04 и управлять версиями Yarn с помощью Corepack.

Предварительные требования

• Сервер с Ubuntu 22.04.
• Настроен пароль root или доступ с sudo.

Установка Node.js

Перед установкой Yarn на сервере должен быть установлен Node.js.

Сначала установите инструмент curl:

apt install curl -y

Добавьте репозиторий Node.js (текущая ветка) и выполните скрипт настройки:

curl -fsSL https://deb.nodesource.com/setup_current.x | bash -

Затем установите пакет nodejs:

apt install nodejs -y

Важно: используйте setup_current.x, если вам нужна последняя стабильная ветка Node.js. Для конкретных версий замените на setup_18.x или другую ветку.

Включение Corepack

Corepack — это менеджер версий пакетов, который упрощает установку Yarn и других менеджеров. Corepack часто устанавливается вместе с Node.js, но по умолчанию может быть отключён. Его нужно включить:

corepack enable

После включения Corepack вы сможете готовить и активировать конкретные версии Yarn.

Установка Yarn на Ubuntu 22.04

С помощью Corepack можно подготовить и активировать нужную версию Yarn для системы или проекта.

Установите и активируйте последнюю стабильную версию Yarn:

corepack prepare yarn@stable --activate

Проверьте версию Yarn:

yarn --version

Пример вывода:

3.2.3

Установка конкретной версии через Corepack тоже проста. Например, чтобы подготовить Yarn 3.1.1:

corepack prepare [email protected] --activate

Чтобы сделать версию 3.1.1 версией по умолчанию в текущем проекте, выполните:

yarn set version 3.1.1

Пример вывода при сохранении релиза в папке .yarn:

? YN0000: Retrieving https://repo.yarnpkg.com/3.1.1/packages/yarnpkg-cli/bin/yarn.js
? YN0000: Saving the new release in .yarn/releases/yarn-3.1.1.cjs
? YN0000: Done in 0s 790ms

Чтобы вернуть версию Yarn к стабильной по умолчанию:

yarn set version stable

Как пользоваться Yarn

Yarn позволяет быстро и просто управлять зависимостями проекта.

Инициализация проекта:

yarn init

Пример результата инициализации:

{
  name: 'root',
  packageManager: '[email protected]'
}

Установка пакета (на примере React):

yarn add react

Пример вывода установки:

? YN0000: ? Resolution step
? YN0000: ? Completed in 0s 332ms
? YN0000: ? Fetch step
? YN0013: ? js-tokens@npm:4.0.0 can't be found in the cache and will be fetched from the remote registry
? YN0013: ? loose-envify@npm:1.4.0 can't be found in the cache and will be fetched from the remote registry
? YN0013: ? react@npm:18.2.0 can't be found in the cache and will be fetched from the remote registry
? YN0000: ? Completed in 0s 418ms
? YN0000: ? Link step
? YN0000: ? Completed
? YN0000: Done in 0s 808ms

Установка конкретной версии пакета:

yarn add package@version

Обновление зависимости:

yarn up package

Удаление пакета:

yarn remove package

Обновление Yarn

Чтобы обновить Yarn до стабильной версии, выполните:

yarn set version stable
yarn install

Удаление Yarn

Если Yarn больше не нужен, его можно отключить через Corepack:

corepack disable yarn

Это не удаляет файлы в .yarn внутри проектов, но отключает глобальное управление версией через Corepack.

Важно: отключение Corepack не удаляет локальные релизы в .yarn/releases в ваших проектах. Их можно удалить вручную при необходимости.

Частые проблемы и устранение неполадок

• yarn: command not found — убедитесь, что Node.js установлен и corepack включён: выполните corepack enable.
• Конфликты версий в проектах — используйте yarn set version внутри каталога проекта, чтобы зафиксировать версию для команды.
• Проблемы с доступом к реестру (EAI_AGAIN или ECONNRESET) — проверьте сетевые настройки, прокси и доступ к https://repo.yarnpkg.com.
• Пакеты не берутся из кэша — проверьте права на папку .yarn/cache и используйте yarn cache clean при необходимости.

Если ошибка остаётся неясной, запустите команду с флагом –verbose для расширенного вывода.

Альтернативные способы установки (когда Corepack не подходит)

• Установка через пакетный менеджер APT (официальный репозиторий Yarn): можно добавить репозиторий Yarn и установить yarn через apt. Этот метод устанавливает глобальную версию, не зависящую от Corepack.
• Установка через npm (как глобальный пакет): npm install -g yarn — полезно в средах, где Corepack отключён или недоступен.

Каждый метод имеет плюсы и минусы: Corepack упрощает управление несколькими версиями в проектах; apt даёт системную установку; npm даёт быстрое глобальное решение.

Контрольный список по ролям

• Для администратора сервера:

  • Установить curl и Node.js.
  • Включить Corepack и проверить доступность yarn.
  • Настроить прокси и разрешения на каталоги .yarn и node_modules.

• Для разработчика проекта:

  • Выполнить yarn set version <версия> в корне проекта при необходимости фиксировать версию.
  • Добавить .yarn/releases в систему контроля версий, если команда этого требует.
  • Использовать yarn up для обновлений зависимостей по мере необходимости.

Командная памятка (cheat sheet)

apt install curl -y
curl -fsSL https://deb.nodesource.com/setup_current.x | bash -
apt install nodejs -y
corepack enable
corepack prepare yarn@stable --activate
yarn --version
yarn init
yarn add react
yarn up package
yarn remove package
yarn set version stable
corepack disable yarn

Критерии приёмки

• yarn –version выводит версию Yarn (например, 3.x.x).
• Команды yarn add / yarn remove успешно устанавливают и удаляют пакеты.
• Проекты с зафиксированной версией Yarn используют ту версию, которая указана в .yarn/releases.

Сводка

Yarn через Corepack — это удобный и рекомендуемый способ управлять версиями менеджера пакетов в проектах на Ubuntu 22.04. Процесс: установить Node.js, включить Corepack, подготовить/активировать нужную версию Yarn. Для редких случаев доступны альтернативы через apt или npm.

Ключевые действия: установить curl и Node.js, выполнить corepack enable, затем corepack prepare yarn@stable –activate и проверить yarn –version.

1-строчный словарь терминов:

• Corepack — инструмент для управления версиями менеджеров пакетов (yarn, pnpm и т.д.) на уровне разработчика и проекта.