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

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

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

Створюємо LXC-контейнер використавши шаблон ubuntu-14.04-standart-amd64-ROR-Nginx-Passenger-Postgres-Capistrano (опис деплоя з нуля)

Заходимо через консоль, та задаємо пароль для користувача deployer

passwd deployer

1	passwd deployer

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

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;

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

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

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

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

та додаємо ключ на git-сервер

cat ~/.ssh/id_rsa.pub

1	cat ~/.ssh/id_rsa.pub

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

Для деплоя проекту, нам потрібний 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/project'
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'
# Uploading both linked_files and dirs
before :finishing, 'linked_files:upload'

# Uploading only linked_files
before :finishing, 'linked_files:upload_files'

# Uploading only dirs
before :finishing, 'linked_files:upload_dirs'
end

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

set :application, 'tools'

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

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

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

set :branch, 'master'

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

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

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'

# Uploading both linked_files and dirs

before :finishing, 'linked_files:upload'

# Uploading only linked_files

before :finishing, 'linked_files:upload_files'

# Uploading only dirs

before :finishing, 'linked_files:upload_dirs'

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!

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

cap production deploy

bundle exec cap production linked_files:upload_files

cap production deploy

Можливі проблеми:

NoMethodError: undefined method `[]' for nil:NilClass – переімуневати усі .css файли у .scss

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

WebDevelop

Deploy Ruby on Rails – Nginx/Passenger/Postgres/Capistrano/LXC

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

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