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

Это руководство раскрывает, как настроить среду для разработки ядра Ruby on Rails.

После прочтения этого руководства, вы узнаете:

• Как настроить свою машину для разработки Rails

1. Простой способ

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

2. Сложный способ

В случае, если нет возможности использовать Rails development box, вот шаги для создания среды разработки для ядра Ruby on Rails.

2.1. Установите Git

Ruby on Rails использует Git для контроля кода. На домашней странице Git есть инструкции по установке. Также в сети есть ряд ресурсов, которые помогут познакомиться с Git:

• Курс Try Git — это интерактивный курс, который научит основам.
• Официальная документация довольно объемная, а также содержит несколько видео с основами Git.
• Everyday Git научит достаточному, чтобы работать с Git.
• GitHub предлагает ссылки на ряд ресурсов по Git.
• Pro Git — это целая книга о Git с лицензией Creative Commons.

2.2. Клонируйте репозиторий Ruby on Rails

Перейдите в папку, в которой вы хотите разместить исходный код Ruby on Rails (он создаст свою собственную поддиректорию rails), и запустите:

$ git clone https://github.com/rails/rails.git
$ cd rails

2.3. Установка дополнительных инструментов и сервисов

Некоторые тесты Rails зависят от дополнительных инструментов, которые необходимо установить перед запуском этих определенных тестов.

Вот список дополнительных зависимостей каждого гема:

• Action Cable зависит от Redis
• Active Record зависит от SQLite3, MySQL и PostgreSQL
• Active Storage зависит от Yarn (дополнительно, Yarn зависит от Node.js), ImageMagick, FFmpeg, muPDF, и на macOS также XQuartz и Poppler.
• Active Support зависит от memcached и Redis
• Railties зависит от runtime окружения JavaScript, например от наличия установленного Node.js.

Установите все зависимости, которые необходимы для надлежащего тестирования гема, в который вы будете вносить изменения.

Ниже приведены инструкции, как установить все дополнительные инструменты для различных ОС.

2.3.1. macOS

На macOS можно использовать Homebrew для установки всех дополнительных инструментов.

Чтобы все установить, запустите

$ brew bundle

Также нужно запустить каждый из установленных сервисов. Чтобы отобразить все доступные сервисы, запустите:

$ brew services list

Затем можно запустить каждый из этих сервисов один за другим подобным образом:

$ brew services start mysql

Замените mysql именем того сервиса, который вы хотите запустить.

2.3.2. Ubuntu

Чтобы все установить, запустите:

$ sudo apt-get update
$ sudo apt-get install sqlite3 libsqlite3-dev mysql-server libmysqlclient-dev postgresql postgresql-client postgresql-contrib libpq-dev redis-server memcached imagemagick ffmpeg mupdf mupdf-tools libxml2-dev

# Install Yarn
$ curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
$ echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
$ sudo apt-get install yarn

2.3.3. Fedora или CentOS

Чтобы все установить, запустите:

$ $ sudo dnf install sqlite-devel sqlite-libs mysql-server mysql-devel postgresql-server postgresql-devel redis memcached imagemagick ffmpeg mupdf libxml2-devel

# Install Yarn
# Используйте эту команду, если у вас нет установленной Node.js
$ curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
# Если у вас есть установленная Node.js, используйте эту команду
$ curl --silent --location https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
$ sudo dnf install yarn

2.3.4. Arch Linux

2.3.5. MySQL и PostgreSQL

Чтобы все установить, запустите:

$ sudo pacman -S sqlite mariadb libmariadbclient mariadb-clients postgresql postgresql-libs redis memcached imagemagick ffmpeg mupdf mupdf-tools poppler yarn libxml2
$ sudo mariadb-install-db --user=mysql --basedir=/usr --datadir=/var/lib/mysql
$ sudo systemctl start redis mariadb memcached

2.3.6. FreeBSD

Чтобы все установить, запустите:

$ pkg install sqlite3 mysql80-client mysql80-server postgresql11-client postgresql11-server memcached imagemagick ffmpeg mupdf yarn libxml2
# portmaster databases/redis

Или установить все с помощью портов (эти пакеты расположены в папке databases).

2.4. Конфигурация базы данных

Имеется ряд дополнительных шагов, необходимых для конфигурации движка баз данных, требуемых для запуска тестов Active Record.

Чтобы иметь возможность запускать тестовый набор на MySQL, необходимо создать пользователя с именем rails с привилегиями на тестовые базы данных:

$ mysql -uroot -p

mysql> CREATE USER 'rails'@'localhost';
mysql> GRANT ALL PRIVILEGES ON activerecord_unittest.*
       to 'rails'@'localhost';
mysql> GRANT ALL PRIVILEGES ON activerecord_unittest2.*
       to 'rails'@'localhost';
mysql> GRANT ALL PRIVILEGES ON inexistent_activerecord_unittest.*
       to 'rails'@'localhost';

Аутентификация PostgreSQL работает по-другому. Чтобы настроить среду разработки для своего аккаунта на Linux или BSD, просто запустите:

$ sudo -u postgres createuser --superuser $USER

и для macOS:

$ createuser --superuser $USER

Затем нужно создать тестовые базы данных для MySQL и PostgreSQL с помощью:

$ bundle exec rake db:create

Можно создать тестовые базы данных для каждого движка базы данных отдельно:

$ cd activerecord
$ bundle exec rake db:mysql:build
$ bundle exec rake db:postgresql:build

Можно удалить базы данных с помощью:

$ cd activerecord
$ bundle exec rake db:drop

Если вы используете другую базу данных, ищите в файле activerecord/test/config.yml или activerecord/test/config.example.yml информацию по соединению по умолчанию. Можно отредактировать activerecord/test/config.yml, чтобы представить другие учетные данные для вашей машины, если необходимо, но, очевидно, вы не должны отправлять такие изменения обратно в Rails.

2.5. Установка зависимостей JavaScript

Документация Redis отговаривает от установки с помощью пакетных менеджеров, так как они обычно устаревшие. Установка из исходников и запуск сервера просто и хорошо документированы в документации Redis.

2.5.1. Установка Redis из пакетного менеджера

Если вы установили Yarn, необходимо установить зависимости javascript:

$ cd activestorage
$ yarn install

2.6. Установка гема Bundler

Получите последнюю версию Bundler

$ gem install bundler
$ gem update bundler

и запустите:

$ bundle install

или:

$ bundle install --without db

если вы не хотите запускать тесты Active Record.

2.7. Вносите вклад в Rails

После того, как вы все настроили, прочитайте, как можно начать вносить свой вклад.