Як встановити та налаштувати Ruby за допомогою Rbenv, Rails, MariaDB, Nginx, SSL та Passenger в Ubuntu 17.04

Ruby on Rails — це популярний веб-фреймворк для Ruby, який був розроблений для підвищення продуктивності програміста. Однак змусити різноманітні дорогоцінні камені та залежності працювати разом іноді може бути складно. Цей посібник допоможе вам налаштувати повністю готове до виробництва середовище Rails, включаючи часто використовувані gems та залежності.

Вимоги

• Примірник Vultr з принаймні 512 МБ оперативної пам’яті (бажано 1024 МБ).
• Примірник Vultr під керуванням Ubuntu 17.04.

Стек, що використовується в цьому посібнику

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

Установка

Додати користувача Sudo

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

sudo adduser deploy
sudo adduser deploy sudo
su deploy

Оновлення та оновлення системи

Переконайтеся, що на своїй VM Ubuntu запущено всі останні пакунки:

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

Встановіть систему збірки

Для того, щоб мати можливість компілювати Ruby за допомогою rbenv та інших gems , необхідно встановити різні пакунки. Залежно від версії 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

Версійність

Спільнота 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

Нокогірі

Необхідний для кількох популярних дорогоцінних каменів, яким потрібні власні бібліотеки 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. Це найпростіший спосіб встановлення, який дозволяє легко оновлювати пізніше. Також install 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 за допомогою whenevergem, він використовуватиме ту саму версію 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

Passenger і 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

Додайте сховище Passenger:

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, додаток і налаштуйте Passenger

Встановіть 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 у /var/www/. Якщо у вас уже є програма, яку ви хочете розгорнути, git cloneзапустіть її тут, а потім bundle:

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

Налаштуйте Passenger так, щоб він вказував на програму.

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. Скажіть Passenger, щоб він використовував наші налаштування 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 

Як останній, але необов’язковий крок, перезавантажте віртуальну машину та переконайтеся, що всі служби перезапущено, як очікувалося.