Установка Ruby на Debian 10

TL;DR

Кратко: есть три надёжных способа установить Ruby на сервер с Debian 10 — через RVM, rbenv или из APT-репозитория. RVM и rbenv подходят, если нужны несколько версий и изолированные окружения; APT — самый быстрый для системной установки, но версия будет старее. В статье приведены пошаговые команды, проверка установки, советы по выбору и чек-листы для администратора и разработчика.

Важно: перед началом сделайте полное обновление системы и имейте доступ root или эквивалент sudo.

О чём эта инструкция

Эта статья объясняет три способа установки Ruby на Debian 10 и помогает выбрать метод в зависимости от целей. Краткие определения:

RVM — менеджер Ruby, который управляет несколькими версиями и набором гемов per-user.
rbenv — лёгкий менеджер версий Ruby, фокусируется на переключении версий, обычно в связке с ruby-build.
APT (Debian repository) — установка системного пакета ruby-full, простая, но не всегда предоставляет новейшие версии.

Требования

Сервер с Debian 10.
Пароль root или пользователь с правами sudo.
Доступ в интернет для загрузки пакетов и GPG-ключей.

Подготовка системы

Обновите систему перед установкой:

apt-get update -y  
apt-get upgrade -y

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

Установка Ruby с помощью RVM

Когда выбирать RVM:

Нужна простая работа с наборами (gemsets) и per-user окружениями.
Требуется инсталляция нескольких версий Ruby для разных проектов.

Установка зависимостей для сборки Ruby из исходников:

apt-get install curl gnupg gnupg2 build-essential libgdbm-dev libncurses5-dev automake libtool bison libffi-dev -y

Импортируйте GPG-ключи RVM (команды — как в исходнике):

curl -sSL https://rvm.io/mpapis.asc | gpg --import -

Ожидаемый вывод (пример):

gpg: key 3804BB82D39DC0E3: 47 signatures not checked due to missing keys
gpg: /root/.gnupg/trustdb.gpg: trustdb created
gpg: key 3804BB82D39DC0E3: public key "Michal Papis (RVM signing) <[email protected]>" imported
gpg: Total number processed: 1

Добавьте второй ключ:

curl -sSL https://rvm.io/pkuczynski.asc | gpg --import -

Ожидаемый вывод (пример):

gpg: key 105BD0E739499BDB: public key "Piotr Kuczynski <[email protected]>" imported
gpg: Total number processed: 1
gpg:               imported: 1

Установите RVM:

curl -sSL https://get.rvm.io | bash -s stable

Пример выходных сообщений установки (сокращённо):

GPG verified '/usr/local/rvm/archives/rvm-1.29.9.tgz'
Creating group 'rvm'
Installing RVM to /usr/local/rvm/
Installation of RVM in /usr/local/rvm/ is almost complete:

  * First you need to add all users that will be using rvm to 'rvm' group,
    and logout - login again, anyone using rvm will be operating with `umask u=rwx,g=rwx,o=rx`.

  * To start using RVM you need to run `source /etc/profile.d/rvm.sh`
    in all your open shell windows, in rare cases you need to reopen all shell windows.
  * Please do NOT forget to add your users to the rvm group.
     The installer no longer auto-adds root or users to the rvm group. Admins must do this.
     Also, please note that group memberships are ONLY evaluated at login time.
     This means that users must log out then back in before group membership takes effect!
Thanks for installing RVM ????
Please consider donating to our open collective to help us maintain RVM.

????  Donate: https://opencollective.com/rvm/donate

Активируйте RVM в текущей сессии:

source /etc/profile.d/rvm.sh

Установка последней версии Ruby через RVM:

rvm install ruby

Пример вывода после установки Ruby (сокращено):

ruby-2.6.3 - #generating global wrappers.......
ruby-2.6.3 - #gemset created /usr/local/rvm/gems/ruby-2.6.3
ruby-2.6.3 - #importing gemsetfile /usr/local/rvm/gemsets/default.gems evaluated to empty gem list
ruby-2.6.3 - #generating default wrappers.......
ruby-2.6.3 - #adjusting #shebangs for (gem irb erb ri rdoc testrb rake).
Install of ruby-2.6.3 - #complete 
Ruby was built without documentation, to build it run: rvm docs generate-ri

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

ruby -v

Ожидаемый вывод (пример):

ruby 2.6.3p62 (2019-04-16 revision 67580) [x86_64-linux]

Установка Bundler (для управления зависимостями):

gem install bundler

Установка конкретной версии Ruby и смена версии по умолчанию:

rvm install ruby-2.6.0
rvm --default use ruby-2.6.0

Удаление версии Ruby через RVM:

rvm remove ruby-2.6.3
rvm remove ruby-2.6.0

Примечание: добавьте пользователей в группу rvm и затем выполните повторный вход в систему, чтобы групповая принадлежность вступила в силу.

Установка Ruby из репозитория Debian

Когда выбирать APT:

Нужна быстрая и простая системная установка.
Не требуется свежайшая версия Ruby.

Установите пакет “ruby-full”:

apt-get install ruby-full -y

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

ruby -v

Пример вывода (пример):

ruby 2.5.5p157 (2019-03-15 revision 67260) [x86_64-linux-gnu]

Удаление:

apt-get remove ruby-full
apt-get autoremove

Примечание: системный пакет устанавливается глобально и может конфликтовать с версиями, установленными через RVM или rbenv. Для проектов, требующих отдельных версий, используйте RVM или rbenv.

Установка Ruby с помощью rbenv

Когда выбирать rbenv:

Нужно лёгкое переключение версий Ruby без управления gemset’ами.
Предпочитаете простую архитектуру, минимальное влияние на shell окружение.

Установка зависимостей:

apt-get install git curl libssl-dev libreadline-dev zlib1g-dev autoconf bison build-essential libyaml-dev libncurses5-dev libffi-dev libgdbm-dev -y

Установка rbenv и ruby-build скриптов:

curl -sL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-installer | bash -

Вывод проверки установки (пример):

Running doctor script to verify installation...
Checking for `rbenv' in PATH: not found
  You seem to have rbenv installed in `/root/.rbenv/bin', but that
  directory is not present in PATH. Please add it to PATH by configuring
  your `~/.bashrc', `~/.zshrc', or `~/.config/fish/config.fish'.

Добавьте rbenv в PATH и инициализацию в ~/.bashrc:

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc

Активируйте изменения:

source ~/.bashrc

Установите Ruby (пример 2.6.0):

rbenv install 2.6.0
rbenv global 2.6.0

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

ruby -v

Ожидаемый вывод (пример):

ruby 2.6.0p0 (2018-12-25 revision 66547) [x86_64-linux]

Примечание: после установки гемы устанавливаются в пользовательское окружение rbenv, что удобно для изоляции проектов.

Как выбрать метод — краткая рекомендация

Если нужен простой системный Ruby для утилит или скриптов: используйте APT.
Если вам важна поддержка нескольких версий и gemset’ов: выберите RVM.
Если хотите минималистичный менеджер версий с меньшим вмешательством в окружение: выберите rbenv.

flowchart TD
  A[Нужна последняя версия и per-user gemset?] -->|Да| B[RVM]
  A -->|Нет| C[Нужно переключать версии, но без gemset?]
  C -->|Да| D[rbenv]
  C -->|Нет| E[APT]
  B --> F[Установка и управление RVM]
  D --> G[Лёгкий менеджер версий]
  E --> H[Системная установка через apt]

Чек-лист для администратора и разработчика

Администратор (sysadmin):

Выполнить apt-get update/upgrade перед началом.
Создать резервную копию конфигураций и убедиться в доступе root.
Проверить наличие всех build-зависимостей.
Если устанавливаете RVM — добавить нужных пользователей в группу rvm и сообщить о необходимости повторного входа.
Настроить политику обновлений для системного Ruby (если используется APT).

Разработчик:

Определиться с методом в проекте и документировать команду установки для команды.
Зафиксировать версию Ruby в .ruby-version (rbenv) или в README (RVM).
Настроить Bundler и Gemfile для управления зависимостями.

Таблица-команд: быстрый чектлист

Действие	Команда
Обновление системы	apt-get update -y && apt-get upgrade -y
Установить зависимости для RVM	apt-get install curl gnupg … -y

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

Команда ruby -v возвращает ожидаемую версию, установленную выбранным методом.
Bundler доступен (если требуется) и gem install работает без ошибок.
Для RVM: пользователь добавлен в группу rvm и после повторного входа RVM доступен.
Для rbenv: PATH и eval rbenv init настроены, rbenv versions показывает установленную версию.

Когда установка может не работать и как устранить

Ошибка сборки при установке Ruby из исходников: проверьте, установлены ли все пакеты build-essential и dev-зависимости (libssl-dev, libreadline-dev, zlib1g-dev и др.).
GPG-ключи не импортируются: проверьте доступность HTTPS и разрешение на подключение к rvm.io.
rbenv не виден в PATH: убедитесь, что строки добавлены в ~/.bashrc и выполнен source ~/.bashrc или перезайдите в сессию.
Конфликты версий между APT и RVM/rbenv: не смешивайте системную установку с per-user менеджерами на одном пути выполнения. Если нужно — используйте контейнеризацию или изоляцию окружений.

Дополнительные советы по безопасности и совместимости

Не устанавливайте гемы под root без крайней необходимости. Лучше работать от имени обычного пользователя и использовать gemset или bundler.
Для серверных приложений используйте systemd unit-файлы, которые явно указывают путь к используемому Ruby (rbenv shim или путь RVM).
При развёртывании в продакшн фиксируйте версии Ruby и гемов (Gemfile.lock), чтобы избежать неожиданного поведения после обновлений.

Краткий итог

Выберите метод, который соответствует вашему рабочему процессу: APT для простоты, rbenv для минимализма и совместимости, RVM для гибкого управления версиями и gemset’ов. Следуйте приведённым шагам, проверяйте ruby -v и документируйте выбранный подход в проекте.

Если хотите, могу подготовить короткую инструкцию по установке для конкретного проекта (например, Rails-приложение) или сгенерировать systemd unit-файл с учётом используемого менеджера версий.