Как установить и настроить Ruby с помощью Rbenv, Rails, MariaDB, Nginx, SSL и Passenger в Ubuntu 17.04

• Требования
• Стек, используемый в этом руководстве
• Установка
• Дополнительные пакеты
• Установите сервер MariaDB
• Установите Rbenv и Ruby

Ruby on Rails - это популярный веб-фреймворк для Ruby, разработанный для повышения производительности труда программиста. Тем не менее, получение различных гемов и зависимостей для совместной работы может иногда быть сложным. Это руководство поможет вам настроить полностью готовую к работе среду Rails, включая часто используемые гемы и зависимости.

Требования

• Экземпляр Vultr с не менее 512 МБ ОЗУ (предпочтительно 1024 МБ).
• Экземпляр Vultr под управлением Ubuntu 17.04.

Стек, используемый в этом руководстве

• Nginx : быстрый и мощный веб-сервер. (версия 1.10.3)
• Пассажир : сервер приложений, который поможет Nginx обслуживать ваше приложение Ruby. (версия 1.5.1.8)
• Rbenv : менеджер версий Ruby. (версия 1.1.1-2)
• Рубин : (версия 2.4.1)
• MariaDB : ветка с открытым исходным кодом сервера MySQL (версия 10.2)
• SSL- сертификат от Let's Encrypt

Установка

Добавить пользователя Sudo

Примечание . Настоятельно рекомендуется не устанавливать ни одну из этих служб от имени пользователя root, поскольку вы можете подвергнуться атаке. Настройка пользователя deployили appявляется общим соглашением:

sudo adduser deploy
sudo adduser deploy sudo
su deploy

Обновление и обновление системы

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

sudo apt-get update && sudo apt-get upgrade -y

Установить систему сборки

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

составление

sudo apt-get install -y curl zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev
sudo apt-get install -y libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev
sudo apt-get install -y python-software-properties libffi-dev
sudo apt-get install -y build-essential openssl libreadline6 libreadline6-dev libreadline-dev
sudo apt-get install -y automake libtool bison pkg-config bison autoconf libc6-dev ncurses-dev
sudo apt-get install -y libapr1-dev libaprutil1-dev libx11-dev libffi-dev tcl-dev tk-dev

Пакеты для поддержки SSL

Это необходимо для компиляции нескольких драгоценных камней, таких как Passenger:

sudo apt-get install -y zlib1g zlib1g-dev libssl-dev libyaml-dev libcurl4-openssl-dev libruby

Versioning

Сообщество Ruby использует Git как предпочтительный SCM; но также могут быть установлены дополнительные, такие как Mercurial или Subversion:

sudo apt-get install -y git git-core

Драйверы базы данных для MySQL / MariaDB

sudo apt-get install -y libmysqld-dev mysql-client libmysqlclient-dev

Nokogiri

Требуется для нескольких популярных гемов, которым нужны нативные библиотеки XML:

sudo apt-get install -y libxml2-dev libxslt-dev

Node.js

Добавьте официальные репозитории из Node с последней версией, так как стандартные репозитории Ubuntu отстают от нескольких основных версий:

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs

Дополнительные пакеты

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

Графики и изображения

Эти библиотеки не являются необходимыми и могут быть пропущены, если вы не планируете использовать гем манипуляции с изображениями; такие как Rmagick:

sudo apt-get install -y imagemagick libmagickwand-dev libvips-dev

Драйверы баз данных для SQLite и PostgreSQL

Установите драйверы для SQLite или PostgreSQL, если вам нужно подключиться к другим базам данных или предпочитаете простую локальную БД:

sudo apt-get install -y libsqlite3-dev sqlite3  libpq-dev postgresql postgresql-contrib

инструменты

Утилиты, которые обычно не поставляются предварительно установленными при новой установке Ubuntu. Не стесняйтесь установить ваш текстовый редактор по выбору:

sudo apt-get install -y iotop htop nano vim

Установите сервер MariaDB

MariaDB - это мощный реляционный SQL-сервер, полностью совместимый с MySQL. Самый простой способ установить последнюю версию MariaDB - использовать официальные репозитории:

sudo apt-get install software-properties-common
sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386] http://ftp.utexas.edu/mariadb/repo/10.2/ubuntu zesty main'
sudo apt update
sudo apt install -y mariadb-server

Следуйте инструкциям и установите пароль root. После убедитесь, что вы можете получить доступ к вашей новой установке:

mysql -V 

Будет отображена строка, подобная этой:

mysql  Ver 15.1 Distrib 10.2.8-MariaDB, for debian-linux-gnu (x86_64) using readline 5

Войдите в оболочку MySQL:

mysql -h localhost -u root -p 

Примечание : используйте \qдля выхода.

Установите Rbenv и Ruby

Rbenv

Установите Rbenv с помощью git. Это самый простой метод установки, который позволяет легко обновлять его позже. Также установите ruby-build, он отвечает за фактическую компиляцию различных версий Ruby:

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

Примечание : когда вам нужно просто обновить cd ~/.rbenvи git pull.

Сделайте Rbenv и Ruby-build доступными в оболочке. Для того, чтобы гарантировать , что экспортные линии вставляются в начале этого .bashrcфайла, что важно для не интерактивных команд Баша, используйте следующие строки:

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

cat ~/.temp_bashrc ~/.bashrc > ~/.combined_bashrc && mv ~/.combined_bashrc ~/.bashrc && rm ~/.temp_bashrc

exec $SHELL

Проверьте, установлены ли Rbenv и Ruby-build и доступны ли они в оболочке:

rbenv install --list

Если rbenvне распознается, выйдите из системы и снова войдите в оболочку.

Создайте ~/.bash_profileфайл и укажите его в качестве источника вашего ~/.bashrcфайла. Если вам нужно запускать какие-либо неинтерактивные команды оболочки из вашего приложения Rails, например, задание cron, заданное wheneverгемом, оно будет использовать ту же версию Ruby, что и ваша интерактивная оболочка. Это может помочь предотвратить странные ошибки. Добавьте эту строку в ~/.bash_profileфайл:

if [ -f $HOME/.bashrc ]; then
        source $HOME/.bashrc
fi

Рубин

Установите Ruby 2.4.1:

rbenv install 2.4.1

Примечание . Этот процесс может занять 5-15 минут в зависимости от ресурсов вашей виртуальной машины, и индикатор выполнения отсутствует.

Сделайте Rbenv доступным везде.

rbenv global 2.4.1

Пассажир и Nginx

Добавьте ключ PGP и поддержку HTTPS для apt:

sudo apt-get install -y dirmngr gnupg
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 561F9B9CAC40B2F7
sudo apt-get install -y apt-transport-https ca-certificates

Добавьте репозиторий Пассажира:

sudo sh -c 'echo deb https://oss-binaries.phusionpassenger.com/apt/passenger zesty main > /etc/apt/sources.list.d/passenger.list'
sudo apt-get update

Установите модули Passenger + Nginx:

sudo apt-get install -y nginx
sudo apt-get install -y libnginx-mod-http-passenger

Посетите ваш экземпляр Vultr, используя его доменное имя или IP, чтобы проверить их на этом этапе. Если они работают, на вашей странице будет показана страница приветствия Nginx по умолчанию.

Настройка Rails, приложение и настройка пассажиров

Установите Bundler и Rails:

gem install bundler rails --no-ri --no-rdoc

Соглашение Ubuntu / Debian - настроить приложение в /var/www. По умолчанию он доступен для записи только пользователю root. Чтобы настройки работали, передайте права владения пользователю sudo deploy:

sudo chown deploy:deploy /var/www -R

Создайте приложение rails in /var/www/. Если у вас уже есть приложение, которое вы хотите развернуть, git cloneзапустите его здесь bundle:

cd /var/www
rails new example --database=mysql

Настройте Пассажира, чтобы он указывал на приложение.

1. Приготовьте Nginx.

   sudo nano /etc/nginx/nginx.conf
   

2. Изменить пользователя на deploy.

   user deploy;
   

3. В httpразделе конфигурации должна быть строка, которая говорит Nginx загружать модули, включая пассажирские. Если он отсутствует, вы можете добавить его сразу после Virtual Host Configsзаголовка, но до sites-enabled.

   include /etc/nginx/conf.d/*.conf;
   

4. Редактировать / создать passenger.confфайл.

   sudo nano /etc/nginx/conf.d/mod-http-passenger.conf
   

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

   passenger_ruby /home/deploy/.rbenv/shims/ruby;
   passenger_root /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini;
   

6. Настройте виртуальный хост, чтобы он указывал на приложение в /var/www/example/.

   sudo nano /etc/nginx/sites-enabled/example.conf
   
   
   server {
     listen 80;
     server_name example.com www.example.com;
     root /var/www/example/public;
     passenger_enabled on;
   
     # When you are ready to switch to production mode - change this to `production`
     passenger_app_env development; # <-- !important      
   }
   

7. Перезапустите Nginx.

   sudo service nginx restart
   

На этом этапе ваше приложение готово к использованию в режиме разработки. Чтобы переключиться в рабочий режим, вам нужно вернуться в конфигурацию Nginx и изменить rails_envнастройку на production.

Перед тем, как перейти в режим производства, вы все равно нужно будет настроить вашу производственную базу данных example_production, database.ymlи секретный ключ. Воспользуйтесь таким инструментом, как Capistrano или Mina, чтобы ускорить процесс развертывания приложения. Хорошей практикой является использование переменных ENV с подобным гемом dotenv, и не фиксируйте свои пароли, секретные ключи и тому подобное в своем хранилище git.

Настроить SSL

Существует несколько сервисов, предлагающих SSL-сертификаты для вашего домена, многие платные, а пара бесплатна. Настройте SSL независимо от того, какой сервис вы используете. Let's Encrypt очень прост и бесплатен в использовании. Let's Encrypt - некоммерческая организация, поддерживаемая многими техническими гигантами.

Установка

Выполните следующие команды и следуйте инструкциям.

sudo apt-get update
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:certbot/certbot
sudo apt-get update
sudo apt-get install python-certbot-nginx
sudo certbot --nginx
sudo certbot renew --dry-run

Если вы перейдете к своему экземпляру Vultr, используя сейчас HTTPS, вы увидите защищенный веб-сайт.

обновление

Срок действия вашего нового сертификата истекает, и его необходимо будет периодически обновлять. Самый простой способ сделать это - настроить работу cron.

sudo crontab -e 
30 2 * * 1 /usr/bin/certbot renew 

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