Как установить Ruby on Rails на Debian 12

Ruby on Rails или RoR — это бесплатный и открытый фреймворк веб-приложений, написанный на Ruby и выпущенный под лицензией MIT. Rails — это полный стек веб-фреймворка для легкого создания приложений корпоративного уровня. Rails поставляется с различными инструментами, которые позволяют разработчикам легко создавать как фронтенд, так и бэкенд приложения. Ruby on Rails также имеет встроенные функции безопасности, такие как защита от распространенных атак, таких как SQL-инъекции, XSS и CSRF.

Ruby on Rails предоставляет стандартную структуру для базы данных, рендеринга HTML-шаблонов, веб-сервиса и веб-страницы. Он следует архитектуре модель-представление-контроллер (MVC) и также использует известные философии проектирования, такие как Не повторяй себя (DRY), Конвенция вместо конфигурации (CoC) и паттерн активных записей. Ruby on Rails был разработан, чтобы быть быстрым и простым в использовании и изучении. Некоторые известные сайты, разработанные с помощью Rails, такие как Twitch, Airbnb, Github, Soundcloud и т.д.

В этом руководстве мы проведем вас через установку Ruby on Rails на сервер Debian 12. Вы установите Ruby on Rails с сервером базы данных PostgreSQL и менеджером версий Ruby Rbenv. Вы также создадите каркас, основную структуру проекта Rails.

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

Перед началом убедитесь, что у вас есть:

• Сервер Debian 12.
• Непривилегированный пользователь с правами администратора sudo.

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

На первом этапе вы установите некоторые основные зависимости на вашем сервере Debian. Это включает сервер базы данных PostgreSQL, который будет использоваться в качестве базы данных для вашего проекта Rails, node.js и менеджер пакетов Yarn, который будет использоваться Rails для компиляции статических ресурсов.

Для начала обновите и обновите индекс пакетов, выполнив команду apt update ниже.

sudo apt update

Затем установите зависимости, используя следующую команду apt install. Это включает сервер базы данных PostgreSQL, драйвер libpq, Node.js, Yarn, Git и некоторые системные библиотеки и инструменты.

sudo apt install postgresql libpq-dev nodejs yarnpkg git zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev

Введите y, чтобы подтвердить и продолжить установку.

После установки зависимостей проверьте статус сервера PostgreSQL, используя следующую команду. Это обеспечит работу и включение PostgreSQL на вашем Debian.

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Если PostgreSQL включен, вы должны получить вывод enabled. Когда PostgreSQL работает, вы должны получить вывод active(running) или active(exited).

Наконец, проверьте Node.js и менеджер пакетов Yarn, выполнив команду ниже.

node --version  
yarnpkg --version

В этом примере установлены Node.js 18 и Yarn 1.22.

Установка Rbenv

После установки зависимостей пакетов следующим шагом будет установка Rbenv, менеджера версий Ruby для Unix-подобных операционных систем. С Rbenv вы можете легко управлять средой ваших приложений Ruby, а также устанавливать несколько версий Ruby на вашем компьютере.

Войдите в свою учетную запись пользователя, используя следующую команду.

su - user

Скачайте исходный код rbenv и плагин ruby-build с помощью команды git ниже.

git clone https://github.com/rbenv/rbenv.git ~/.rbenv  
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

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

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

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

source ~/.bashrc

Проверьте rbenv, выполнив команду rbenv ниже. Если установка rbenv прошла успешно, вы должны увидеть доступные команды/опции rbenv.

rbenv commands

Установка Ruby через Rbenv

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

Выполните команду rbenv install ниже, чтобы установить Ruby 3.2.2 в вашу систему.

rbenv install 3.2.2

Во время установки вы должны увидеть это:

После установки Ruby выполните следующую команду, чтобы установить версию Ruby по умолчанию на 3.2.2.

rbenv global 3.2.2

Наконец, проверьте версию Ruby в вашей системе, используя команду ниже.

ruby -v

Если все прошло хорошо, вы должны увидеть, что Ruby 3.2.2 установлен.

Установка Ruby on Rails

На этом этапе ваша система настроена и готова к установке Ruby on Rails на ваш Debian. В этом примере вы установите Ruby on Rails 7.0 и проверите список доступных версий Rails на официальном сайте.

Выполните команды gem ниже, чтобы установить bundler, затем установите Ruby on Rails 7.0.7.2.

gem install bundler  
gem install rails -v 7.0.7.2

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

Теперь выполните команду rebenv ниже, чтобы перехешировать и перезагрузить вашу текущую среду.

rbenv rehash

Наконец, выполните команду rails ниже, чтобы убедиться, что Ruby on Rails установлен.

rails version  
rails -h

Если установка прошла успешно, вы должны увидеть вашу текущую версию Rails и страницу справки команды rails.

Создание первого проекта Rails

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

• Подготовить пользователя PostgreSQL для приложения.
• Создать первый проект Rails.

Подготовка пользователя базы данных

Сначала вам нужно создать нового пользователя PostgreSQL, который будет использоваться для вашего приложения Rails. У этого пользователя должны быть права на создание баз данных и пользователей.

Вернитесь к своей учетной записи пользователя и войдите на сервер PostgreSQL, используя команду ниже.

sudo su  
sudo -u postgres psql

Теперь создайте нового пользователя bob с паролем p4sswordbob. Затем назначьте новые права на создание базы данных и ролей пользователю bob.

CREATE USER bob WITH PASSWORD 'p4sswordbob';  
ALTER USER bob CREATEDB CREATEROLE;

Проверьте список пользователей и прав на вашем сервере PostgreSQL, используя команду ниже.

du

Вы должны увидеть пользователя bob с правами CREATEDB и CREATEROLE.

Введите \q, чтобы выйти из сервера PostgreSQL.

Наконец, войдите в свою учетную запись и выполните следующую команду psql, чтобы войти на сервер PostgreSQL как новый пользователь bob.

su - user  
psql -U bob -h 127.0.0.1 -d postgres

После подключения к серверу PostgreSQL выполните следующий запрос, чтобы проверить вашу информацию о подключении.

\conninfo

Вы должны увидеть, что вы подключены к серверу PostgreSQL как пользователь bob.

Введите \q, чтобы выйти из сервера PostgreSQL.

Создание проекта Rails

После создания пользователя PostgreSQL вы теперь можете начать создание нового проекта Rails с помощью утилиты командной строки rails.

Чтобы создать новый проект rails, выполните команду rails ниже. В этом примере вы создадите новый проект testapp с базой данных по умолчанию PostgreSQL.

rails new testapp -d postgresql

Вывод команды должен выглядеть так:

После создания проекта новая директория ~/testapp также будет создана. Перейдите в директорию ~/testapp и откройте конфигурацию базы данных config/database.yml с помощью вашего предпочтительного текстового редактора.

cd testapp/  
nano config/database.yml

Измените настройки базы данных по умолчанию для разработки, тестирования и производства. Обязательно введите ваше имя пользователя и пароль PostgreSQL.

development:  
  <<: *default  
  database: testapp_development  
  
  # Указанная роль базы данных используется для подключения к postgres.  
  # Чтобы создать дополнительные роли в postgres, смотрите `$ createuser --help`.  
  # Если оставить пустым, postgres будет использовать роль по умолчанию. Это  
  # то же самое имя, что и пользователь операционной системы, запускающий Rails.  
  username: bob  
  
  # Пароль, связанный с ролью postgres (имя пользователя).  
  password: p4sswordbob  
  
  # Подключение по TCP-сокету. По умолчанию опущено, так как клиент использует  
  # доменный сокет, который не требует конфигурации. Windows не имеет  
  # доменных сокетов, поэтому раскомментируйте эти строки.  
  host: localhost  
  
  # TCP-порт, на котором сервер слушает. По умолчанию 5432.  
  # Если ваш сервер работает на другом номере порта, измените соответственно.  
  port: 5432

Сохраните и выйдите из файла, когда закончите.

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

rails db:setup  
rails db:migrate

Ниже вы должны увидеть вывод во время миграции базы данных проекта testapp.

После миграции базы данных выполните команду rails ниже, чтобы запустить проект testapp. Это запустит testapp на вашем IP-адресе на порту 3000.

rails server -b 192.168.10.15

В следующем выводе вы должны увидеть, что testapp работает.

Теперь запустите ваш любимый веб-браузер и посетите ваш IP-адрес сервера, за которым следует порт 3000, например http://192.168.10.15:3000/. Если ваша установка прошла успешно, вы должны увидеть страницу index.html по умолчанию Ruby on Rails.

Нажмите Ctrl+c, чтобы завершить ваше приложение Rails.

Сквозная структура Rails для стартового набора

Сквозная структура — это автоматический способ генерировать основную структуру проекта Rails, которая включает контроллер, модель и представление.

Выполните команду rails ниже, чтобы создать сквозную структуру books с тремя полями title, author и publication_year.

rails g scaffold books title:string author:string publication_year:integer

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

rails db:migrate

Затем запустите ваш проект Rails, выполнив команду сервера rails ниже.

rails server -b 192.168.10.15

После того как testapp запущен, проверьте сквозную структуру книг через URL-адрес /books, например http://192.168.10.15:3000/books. Если все прошло хорошо, вы должны увидеть сгенерированную сквозную структуру, как показано ниже:

Теперь вы можете вставить новые данные в сквозную структуру книг, как показано ниже:

Заключение

В заключение, вы завершили установку Ruby on Rails с сервером базы данных PostgreSQL и Rbenv на сервере Debian 12. Вы также узнали, как генерировать сквозные структуры для основных структур проекта Rails.