Приклад деплоя app на Ruby On Rails

В даній замітці розглядається приклад деплою проетку під назвою tools на VPS-сервер Ubuntu 17.04 в каталог /home/deployer/apps/project/, код проекту знаходиться на git-сервері bitbucket.org у приватному репозиторію. Використовуємо Ruby 2.4.0 та Ruby On Rails 5

Підготовка VPS-серверу

Створюємо користувача deployer, в цілях деплоя нашого app

adduser deployer

1	adduser deployer

Додаємо його в sudo (/etc/sudoers)

deployer ALL=(ALL:ALL) NOPASSWD:ALL

1	deployer ALL=(ALL:ALL) NOPASSWD:ALL

Налаштовуємо часовий пояс

tzselect

tzselect

Задаємо UTF-8 локаль, для цього редагуємо файл /etc/default/locale до наступного вигляду

LANG=uk_UA.UTF-8
LANGUAGE="en_US.UTF-8",
LC_CTYPE="en_US.UTF-8"
LC_NUMERIC="en_US.UTF-8"
LC_TIME=ru_UA.UTF-8
LC_COLLATE="en_US.UTF-8"
LC_MONETARY="en_US.UTF-8"
LC_MESSAGES="en_US.UTF-8"
LC_PAPER="en_US.UTF-8"
LC_NAME="en_US.UTF-8"
LC_ADDRESS="en_US.UTF-8"
LC_TELEPHONE="en_US.UTF-8"
LC_MEASUREMENT="en_US.UTF-8"
LC_IDENTIFICATION="en_US.UTF-8"
LC_ALL="en_US.UTF-8"

LANG=uk_UA.UTF-8

LANGUAGE="en_US.UTF-8",

LC_CTYPE="en_US.UTF-8"

LC_NUMERIC="en_US.UTF-8"

LC_TIME=ru_UA.UTF-8

LC_COLLATE="en_US.UTF-8"

LC_MONETARY="en_US.UTF-8"

LC_MESSAGES="en_US.UTF-8"

LC_PAPER="en_US.UTF-8"

LC_NAME="en_US.UTF-8"

LC_ADDRESS="en_US.UTF-8"

LC_TELEPHONE="en_US.UTF-8"

LC_MEASUREMENT="en_US.UTF-8"

LC_IDENTIFICATION="en_US.UTF-8"

LC_ALL="en_US.UTF-8"

А в /etc/environment добавивмо наступне

LC_ALL=en_US.UTF-8
LANG=en_US.UTF-8

1 2	LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8

Далі виконаємо наступні команди

sudo locale-gen en_US.UTF-8
sudo locale-gen uk_UA.UTF-8
sudo dpkg-reconfigure locales

sudo locale-gen en_US.UTF-8

sudo locale-gen uk_UA.UTF-8

sudo dpkg-reconfigure locales

Оновлюємо встановлений софт та інсталюємо необхідне ПО

sudo apt-get update
sudo apt-get upgrade
sudo apt-get install curl libcurl3 libcurl3-dev nodejs postgresql postgresql-contrib libpq-dev git-core mc imagemagick libmagickwand-dev

sudo apt-get update

sudo apt-get upgrade

sudo apt-get install curl libcurl3 libcurl3-dev nodejs postgresql postgresql-contrib libpq-dev git-core mc imagemagick libmagickwand-dev

Інсталюємо RVM

command curl -sSL https://rvm.io/mpapis.asc | gpg --import -
curl -L get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm
rvm install 2.4.1
rvm use 2.4.1 --default
rvm rubygems current

command curl -sSL https://rvm.io/mpapis.asc | gpg --import -

curl -L get.rvm.io | bash -s stable

source ~/.rvm/scripts/rvm

rvm install 2.4.1

rvm use 2.4.1 --default

rvm rubygems current

Створюємо базу даних та користувача

sudo -u postgres psql

1	sudo -u postgres psql

create user deployer with password 'password';
alter role deployer superuser createrole createdb replication;
create database MYAPP_production owner deployer;

create user deployer with password 'password';

alter role deployer superuser createrole createdb replication;

create database MYAPP_production owner deployer;

Інсталюємо Bundler та Passenger

gem install bundler
gem install passenger

1 2	gem install bundler gem install passenger

Знищуємо nginx, якщо він був встановлений

sudo apt-get purge nginx nginx-full nginx-light nginx-naxsi nginx-common
sudo rm -rf /etc/nginx

1 2	sudo apt-get purge nginx nginx-full nginx-light nginx-naxsi nginx-common sudo rm -rf /etc/nginx

Інсталюємо Nginx та редагуємо конфігураційни файл default-хосту

rvmsudo passenger-install-nginx-module

1	rvmsudo passenger-install-nginx-module

Вище наведена команда скачає, скомпілює та заінсталює ngnix (за змовчанням в /opt/nginx) з підтримкою passenger (в інтерактивному режимі вибераємо Ruby, потім варіант установки – 1)

Конфігураційний файл /opt/nginx/conf/nginx.conf

В моєму випадку було встановлено ruby 2.4.1 та passenger 5.1.11 (для інших версій правимо конфіг у відповідних місцях)

user  deployer;
worker_processes  1;

events {
    worker_connections  1024;
}

http {
    passenger_root /home/deployer/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.11;
    passenger_ruby /home/deployer/.rvm/gems/ruby-2.4.1/wrappers/ruby;
    client_max_body_size 100m;
    include       mime.types;
    default_type  application/octet-stream;

    sendfile        on;

    keepalive_timeout  65;

    server {
        listen       80;
        server_name  localhost;

	root /home/deployer/apps/project/current/public;
	passenger_enabled on;

        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }
    }
}

user deployer;

worker_processes 1;

events {

worker_connections 1024;

}

http {

passenger_root /home/deployer/.rvm/gems/ruby-2.4.1/gems/passenger-5.1.11;

passenger_ruby /home/deployer/.rvm/gems/ruby-2.4.1/wrappers/ruby;

client_max_body_size 100m;

include mime.types;

default_type application/octet-stream;

sendfile on;

keepalive_timeout 65;

server {

listen 80;

server_name localhost;

root /home/deployer/apps/project/current/public;

passenger_enabled on;

error_page 500 502 503 504 /50x.html;

location = /50x.html {

root html;

}

Автозапуска Nginx

Оскільки nginx ми встановлювали не з пакета, а компілювали, скрипт запуска в /etc/ini.d/ відсутній. Тому, створюємо файл /usr/sbin/nginx наступного вмісту

#!/bin/sh
/opt/nginx/sbin/nginx

1 2	#!/bin/sh /opt/nginx/sbin/nginx

та надаємо права для виконання

chmod +x /usr/sbin/nginx

1	chmod +x /usr/sbin/nginx

Тепер добавимо в /etc/rc.local до рядка exit 0 наступне

/usr/sbin/nginx

1	/usr/sbin/nginx

в 17.04 відсутній /etc/rc.local – створюємо його як описану тут

Генерація ssh ключів

Оскільки користувачу deployer потрібний доступ до git-серверу а репозиторій проекту у нас приватний, ми генеруємо ssh-key

ssh-keygen -t rsa -C "<your@mail>"

1	ssh-keygen -t rsa -C "<your@mail>"

копіюємо його, подивившись командою

cat ~/.ssh/id_rsa.pub

1	cat ~/.ssh/id_rsa.pub

на git-сервер нашого проекту

Підготовка проекту на локальній машині для деплоя

Для деплоя проекту, нам потрібний ssh-доступ з докальної машини на VPS-сервер, для цього добавимо ssh-key на сервер deploy'я

ssh-copy-id deployer@<deploy-server.hostname>

1	ssh-copy-id deployer@<deploy-server.hostname>

якщо у config/secrets.yml ми маємо

production:
  secret_key_base: <%= ENV["SECRET_KEY_BASE"] %>

1 2	production: secret_key_base: <%= ENV["SECRET_KEY_BASE"] %>

тоді генеруємо токен

bundle exec rake secret

1	bundle exec rake secret

та вставляємо його замість <%= ENV[“SECRET_KEY_BASE”] %>

Якщо проект в стадії розробки, варто буде в config/environments/production.rb задати

config.consider_all_requests_local = true

1	config.consider_all_requests_local = true

щоб бачити реальні помилки замість сторінки із "we're sorry"

Capistrano

В нашому локальному проекті добавимо наступні gem'и (в Gemfile)

group :development do
  # Джем, який добавляє специфічні для Rails таски, такі як прогон міграцій і компіляція ассетів
  gem 'capistrano-rails'
  gem 'capistrano-rails-console'
  # Джем, який добавляє можливість bundle до capistrano
  gem 'capistrano-bundler'
  # Добалвення підтримки RVM (менеджера версій для Ruby)
  gem 'capistrano-rvm'
  # Інтеграція пасажира и капістрано
  gem 'capistrano-passenger'
  gem 'capistrano-linked-files'
end

group :development do

# Джем, який добавляє специфічні для Rails таски, такі як прогон міграцій і компіляція ассетів

gem 'capistrano-rails'

gem 'capistrano-rails-console'

# Джем, який добавляє можливість bundle до capistrano

gem 'capistrano-bundler'

# Добалвення підтримки RVM (менеджера версій для Ruby)

gem 'capistrano-rvm'

# Інтеграція пасажира и капістрано

gem 'capistrano-passenger'

gem 'capistrano-linked-files'

end

Виконуємо інсталяцію нових gem'ів та capistrano

bundle install
cap install

1 2	bundle install cap install

В результаті у нас з'являться наступні два нові файли
config/deploy.rb
config/deploy/production.rb

Конфігурація config/deploy.rb

# Назва проекту
set :application, 'tools'
# Шляз до tools репозиторія
set :repo_url, 'git@bitbucket.org:username/tools'
# Вітка за змовчанням
set :branch, 'master'
# Директорія для деплоя
set :deploy_to, '/home/deployer/apps/tools'
set :default_stage, 'production'

set :log_level, :info
# Файли та директорії (між деплоями), об'єкти яких немає в проеті потрібно забрати
set :linked_files, %w{config/database.yml}
set :linked_dirs, %w{tmp/pids tmp/cache tmp/sockets vendor/bundle public/uploads}

# А це рекомендують добавити для проектів, які використовують ActiveRecord
set :puma_init_active_record, true

namespace :deploy do

  desc 'Restart application'
  task :restart do
    on roles(:app), in: :sequence, wait: 5 do
      # Your restart mechanism here, for example:
      # execute :touch, release_path.join('tmp/restart.txt')
    end
  end

  after :restart, :clear_cache do
    on roles(:web), in: :groups, limit: 3, wait: 10 do
      # Here we can do anything such as:
      # within release_path do
      #   execute :rake, 'cache:clear'
      # end
    end

    task :seed do
      on roles(:all) do
        within release_path do
          with rails_env: fetch(:rails_env) do
            execute :rake, "db:seed"
          end
        end
      end
    end

    task :precompile do
      on roles(:all) do
        within release_path do
          with rails_env: fetch(:rails_env) do
            execute :rake, "assets:precompile --trace"
          end
        end
      end
    end

    task :setup do
      before "deploy:migrate", :create_db
      invoke :deploy
    end

    task :create_db do
      on roles(:all) do
        within release_path do
          with rails_env: fetch(:rails_env) do
            execute :rake, "db:create"
          end
        end
      end
    end



  end

  after :finishing, 'deploy:cleanup'
end

# Назва проекту

set :application, 'tools'

# Шляз до tools репозиторія

set :repo_url, 'git@bitbucket.org:username/tools'

# Вітка за змовчанням

set :branch, 'master'

# Директорія для деплоя

set :deploy_to, '/home/deployer/apps/tools'

set :default_stage, 'production'

set :log_level, :info

# Файли та директорії (між деплоями), об'єкти яких немає в проеті потрібно забрати

set :linked_files, %w{config/database.yml}

set :linked_dirs, %w{tmp/pids tmp/cache tmp/sockets vendor/bundle public/uploads}

# А це рекомендують добавити для проектів, які використовують ActiveRecord

set :puma_init_active_record, true

namespace :deploy do

desc 'Restart application'

task :restart do

on roles(:app), in: :sequence, wait: 5 do

# Your restart mechanism here, for example:

# execute :touch, release_path.join('tmp/restart.txt')

end

after :restart, :clear_cache do

on roles(:web), in: :groups, limit: 3, wait: 10 do

# Here we can do anything such as:

# within release_path do

# execute :rake, 'cache:clear'

# end

end

task :seed do

on roles(:all) do

within release_path do

with rails_env: fetch(:rails_env) do

execute :rake, "db:seed"

end

task :precompile do

on roles(:all) do

within release_path do

with rails_env: fetch(:rails_env) do

execute :rake, "assets:precompile --trace"

end

task :setup do

before "deploy:migrate", :create_db

invoke :deploy

end

task :create_db do

on roles(:all) do

within release_path do

with rails_env: fetch(:rails_env) do

execute :rake, "db:create"

end

after :finishing, 'deploy:cleanup'

end

Конфігурація config/deploy/production.rb, полягає лише у втсавці ip-адресу vps-серверу

server '<ip>', user: 'deployer', roles: %w{web app db}

1	server '<ip>', user: 'deployer', roles: %w{web app db}

Якщо ви не захотіли по якійсь причині використовувати ключі для доступу до VPS-серверу, ми можете прописати ssh-параметри доступу в цьому файлі

set :ssh_options, {
    forward_agent: false,
    auth_methods: %w(password),
    password: '<your_password>',
    user: 'deployer',
}

set :ssh_options, {

forward_agent: false,

auth_methods: %w(password),

password: '<your_password>',

user: 'deployer',

}

Конфігурація Capfile

require "capistrano/setup"
require "capistrano/deploy"
require 'capistrano/rvm'
require 'capistrano/bundler'
require 'capistrano/passenger'
require 'capistrano/rails/assets'
require 'capistrano/rails/migrations'

require 'capistrano/linked_files'
Dir.glob('lib/capistrano/tasks/*.cap').each { |r| import r }

require "capistrano/setup"

require "capistrano/deploy"

require 'capistrano/rvm'

require 'capistrano/bundler'

require 'capistrano/passenger'

require 'capistrano/rails/assets'

require 'capistrano/rails/migrations'

require 'capistrano/linked_files'

Dir.glob('lib/capistrano/tasks/*.cap').each { |r| import r }

Виконуємо deploy!

bundle exec cap production linked_files:upload_files
cap production deploy

1 2	bundle exec cap production linked_files:upload_files cap production deploy

Веб-Розробка

WebDevelop

Deploy Ruby on Rails – Nginx/Passenger/Postgres/Capistrano (ОНОВЛЕНО)

Підготовка VPS-серверу

Підготовка проекту на локальній машині для деплоя