Как установить Ruby on Rails с помощью rbenv на macOS

Введение

Язык программирования Ruby в сочетании со средой разработки Rails делает разработку приложений быстрой и эффективной.

Один из способов установить Ruby и Rails — использовать инструмент командной строки rbenv. Использование rbenv предоставит вам хорошо контролируемую и надежную среду для разработки ваших приложений Ruby on Rails, что позволит вам легко переключать рабочую версию Ruby по мере необходимости.

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

В этом руководстве вы будете использовать rbenv для установки и настройки Ruby on Rails на локальном компьютере с macOS.

Предпосылки

Чтобы следовать этому руководству, вам понадобятся:

Один компьютер или виртуальная машина с установленной macOS, с административным доступом к этой машине и подключением к Интернету. Это руководство было протестировано на macOS 12.4 Monterey.
Node.js, установленный на вашем компьютере с macOS, как описано в Asset Pipeline, зависит от среды выполнения JavaScript. Node.js предоставляет эту функцию.
Диспетчер пакетов Homebrew установлен на вашем компьютере с macOS.

Шаг 1 — Установка rbenv

На этом шаге вы установите rbenv и убедитесь, что он автоматически запускается при загрузке. Чтобы сделать это в macOS, в этом руководстве будет использоваться менеджер пакетов Homebrew.

Чтобы загрузить пакет rbenv с помощью Homebrew, выполните следующую команду:

brew install rbenv

Это установит rbenv и плагин [ruby-build] (https://github.com/rbenv/ruby-build). Этот подключаемый модуль добавляет команду rbenv install, которая упрощает процесс установки новых версий Ruby. Это может установить несколько других зависимостей и занять некоторое время.

Затем вы добавите команду eval $ (rbenv init -) в свой файл ~/.bash_profile, чтобы rbenv загружался автоматически при открытии файла Терминал. Для этого откройте свой .bash_profile в nano или в вашем любимом текстовом редакторе:

nano .bash_profile

Добавьте в файл следующую строку:

eval "$(rbenv init -)"

Сохраните и закройте файл.

Затем примените изменения, внесенные в файл ~/.bash_profile, к текущему сеансу оболочки:

source ~/.bash_profile

Чтобы убедиться, что rbenv настроен правильно, используйте команду type, которая отобразит дополнительную информацию о команде rbenv:

type rbenv

В окне вашего терминала отобразится следующее:

Outputrbenv is a function
rbenv ()
{
    local command;
    command="${1:-}";
    if [ "$#" -gt 0 ]; then
        shift;
    fi;
    case "$command" in
        rehash | shell)
            eval "$(rbenv "sh-$command" "$@")"
        ;;
        *)
            command rbenv "$command" "$@"
        ;;
    esac
}

На данный момент на вашем компьютере установлены и rbenv, и ruby-build. Это позволит вам установить Ruby из командной строки на следующем шаге.

Шаг 2 — Установка Руби

Теперь, когда плагин ruby-build установлен, вы можете установить любую версию Ruby, которая вам может понадобиться, с помощью одной команды. На этом шаге вы выберете версию Ruby, установите ее на свой компьютер, а затем проверите установку.

Во-первых, используйте флаг -l, чтобы вывести список доступных версий Ruby. Обратите внимание, что также могут быть доступны не указанные в списке последние второстепенные версии. Например, если в выводе этой команды указан Ruby 3.0.5, вы, скорее всего, также сможете установить 3.0.4.

rbenv install -l

Output2.6.10
2.7.6
3.0.4
3.1.2
jruby-9.3.6.0
mruby-3.1.0
picoruby-3.0.0
rbx-5.0
truffleruby-22.1.0
truffleruby+graalvm-22.1.0

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

Для этого руководства мы установим Ruby 3.1.2:

rbenv install 3.1.2

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

После завершения установки установите его в качестве версии Ruby по умолчанию с помощью подкоманды global:

rbenv global 3.1.2

Убедитесь, что Ruby был правильно установлен, проверив номер его версии:

ruby -v

Ваш вывод будет выглядеть примерно так:

Outputruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x86_64-darwin21]

Чтобы установить и использовать другую версию Ruby, запустите команды rbenv с другим номером версии, например rbenv install 2.7.6 и rbenv global 2.7.6.

Теперь у вас установлена одна версия Ruby, и вы установили версию Ruby по умолчанию. Затем вы настроите себя на работу с пакетами и библиотеками Ruby или gems, что позволит вам установить Rails.

Шаг 3 — Работа с драгоценными камнями

Gems – это пакеты библиотек и программ Ruby, которые можно распространять в экосистеме Ruby. Вы используете команду gem для управления этими драгоценными камнями. На этом шаге вы настроите команду gem для подготовки к установке Rails.

Когда вы устанавливаете гем, в процессе установки создается локальная документация. Это может значительно увеличить время процесса установки каждого гема, поэтому вы можете отключить создание локальной документации, создав файл с именем ~/.gemrc, который содержит параметр конфигурации для отключения этой функции:

echo "gem: --no-document" > ~/.gemrc

Сделав это, используйте команду gem для установки Bundler, инструмента, который управляет зависимостями gem для проектов. Это необходимо для корректной работы Rails:

gem install bundler

Вы увидите такой вывод:

Output
Fetching: bundler-2.3.18.gem
Successfully installed bundler-2.3.18
1 gem installed

Вы можете использовать команду gem env, чтобы узнать больше о среде и настройке драгоценных камней. Чтобы увидеть расположение установленных гемов, используйте аргумент home, например:

gem env home

Вы увидите вывод, похожий на этот:

/Users/sammy/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0

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

Шаг 4 — Установка рельсов

Чтобы установить Rails, используйте команду gem install:

gem install rails

Команда gem устанавливает указанный вами gem, а также все зависимости. Rails представляет собой сложную среду веб-разработки и имеет множество зависимостей, поэтому процесс займет некоторое время. В конце концов вы увидите сообщение о том, что Rails установлен вместе с его зависимостями:

Output...
Successfully installed rails-7.0.3.1
35 gems installed

Примечание. Если вы хотите установить другую версию Rails, вы можете перечислить допустимые версии Rails, выполнив поиск, который выведет длинный список возможных версий. Затем вы можете установить конкретную версию, например 4.2.7, используя флаг -v:

gem search '^rails$' --all
gem install rails -v 4.2.7

rbenv работает, создавая каталог shims или библиотек, которые перехватывают вызовы и изменяют или перенаправляют их. В этом случае прокладки указывают командам Ruby на файлы, используемые версией Ruby, которая в данный момент включена. С помощью подкоманды rehash rbenv поддерживает прокладки в этом каталоге для соответствия каждой команде Ruby во всех установленных версиях Ruby на вашем сервере. Всякий раз, когда вы устанавливаете новую версию Ruby или гем, который предоставляет команды, такие как Rails, вы должны использовать rehash.

Чтобы перехешировать каталог прокладок, выполните следующую команду:

rbenv rehash

Проверьте свою установку Rails, распечатав ее версию с помощью этой команды:

rails -v

Вы увидите установленную версию Rails:

Output
Rails 7.0.3.1

Успешно установив Rails, вы можете приступить к тестированию установки Ruby on Rails и начать разработку веб-приложений. На следующем шаге вы узнаете, как обновлять и удалять rbenv и Ruby.

Шаг 5 — Обновление и удаление rbenv и Ruby

При сопровождении проектов полезно знать, как обновлять и удалять при необходимости. На этом шаге вы обновите rbenv, а затем удалите Ruby и rbenv со своего компьютера.

Вы можете обновить rbenv и ruby-build с помощью Homebrew, выполнив следующую команду:

brew upgrade rbenv ruby-build

Если необходимо обновить rbenv или ruby-build, Homebrew сделает это за вас автоматически. Если ваши настройки уже обновлены, вы получите вывод, подобный следующему:

OutputWarning: rbenv 1.2.0 already installed
Warning: ruby-build 20220713 already installed

Это гарантирует, что мы используем самую последнюю доступную версию rbenv.

Когда вы загружаете дополнительные версии Ruby, вы можете накапливать больше версий, чем вам хотелось бы, в каталоге ~/.rbenv/versions. Используя подкоманду uninstall подключаемого модуля ruby-build, вы можете удалить эти предыдущие версии.

Например, выполните следующее, чтобы удалить Ruby версии 2.1.3:

rbenv uninstall 2.1.3

С помощью команды rbenv uninstall вы можете очистить старые версии Ruby, чтобы у вас не было установлено больше, чем вы используете в настоящее время.

Если вы решили, что больше не хотите использовать rbenv, вы можете удалить его из своей системы.

Для этого сначала откройте файл ~/.bash_profile в редакторе:

nano ~/.bash_profile

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

...
eval "$(rbenv init -)"

Как только вы удалите эту строку, сохраните файл и выйдите из редактора.

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

source ~/.bash_profile

Затем удалите rbenv и все установленные версии Ruby с помощью этой команды:

rm -rf `rbenv root`

Наконец, удалите сам пакет rbenv с помощью Homebrew:

brew uninstall rbenv

Проверьте версию rbenv, чтобы убедиться, что она была удалена:

rbenv -v

Вы получите следующий вывод:

Output-bash: /usr/local/bin/rbenv: No such file or directory

Это означает, что вы успешно удалили rbenv со своего компьютера.

Заключение

В этом руководстве вы установили Ruby on Rails с помощью rbenv на macOS. Отсюда вы можете узнать больше о кодировании на Ruby с помощью нашей базы данных PostgreSQL, а не базы данных sqlite3 по умолчанию, которая обеспечивает большую масштабируемость, централизацию и стабильность для ваших приложений.