Самый простой deploy приложения на Ruby on Rails

Полгода назад я написал пост Deploy приложения на RoR 4 с помощью Capistrano 3. Прошло время, я получил много положительных отзывов, но были и отрицательные. Из них можно было понять следующее:

• Инструкция слишком сложная для новичка
• Очень много всего приходится делать «руками»

Я подумал и написал gem 'capistrano3-ubuntu-server-config', который полностью настраивает Ваш «чистый» Ubuntu сервер. Всё, что Вам нужно сделать руками — создать нового пользователя и дать ему права visudo (причем давать ему права на passwordless sudo ему не надо). Он может:

• Настроить SSH (Добавить настройки 'PermitRootLogin no', 'UseDNS no', 'AllowUsers username')
• Создать и настроить swap (размер запрашивается)
• Сделать

  sudo apt-get update

  и

  sudo apt-get upgrade

• Установить из исходников и настроить как чистый Nginx, так и с модулем Pagespeed
• Установить PostgreSQL из репозитория, затем создать суперпользователя БД (имя пользователя и пароль запрашиваются)
• Установить из исходников и настроить Redis
• Установить RVM с последней версией Ruby и gem'ами Rails, Bundler
• Скопировать Ваш приватный ssh ключ (например для доступа к приватному git репозиторию) с локальной машины на сервер и добавить его в ~/.ssh/config
• Установить imagemagick из репозитория (Необходим для Paperclip, постоянно его забываю ставить)
• Установить любые дополнительные пакеты из репозитория (Запрашивает какие именно)

Можно запустить конфигурационный wizard, который узнает, что именно из вышеперечисленного необходимо сделать и заранее спросит все настройки, чтобы можно было потом пойти попить кофе, а можно запустить отдельные таски. Данный gem будет полезен не только Rails разработчикам, а всем, кто использует Capistrano для деплоя.

Эта статья раскроет следующие темы:

• Использование gem'a capistrano3-ubuntu-server-config
• Использование gem'а capistrano3-git-push
• Моя текущая миниатюрная конфигурация Capistrano

gem 'capistrano3-ubuntu-server-config'

Что умеет делать этот gem, я уже рассказал. Перейдем непосредственно к работе с ним. Представим, что у нас чистый веб-сервер на Ubuntu (я тестировал на Ubuntu 14.04). Нам необходимо самим выполнить всего лишь две простые вещи: создать нового пользователя с правами sudo и обеспечить беспарольный вход с Вашей локальной машины на сервер по SSH. Начнем с первого, на сервере, залогинившись под root выполняем:

adduser deployer 
echo "deployer ALL=(ALL) ALL" >> /etc/sudoers

Вместо deployer может быть любое имя пользователя. Непомешало бы еще поменять пароль пользователя root коммандой passwd.

Теперь обеспечим беспарольный вход с локальной машины на сервер по ssh. Для этого на локальной машине выполним (где depoyer — имя пользователя, 111.111.111.111 — адрес сервера):

ssh-copy-id deployer@111.111.111.111

На этом вся настройка сервера завершена. В идеальной ситуации, Вам больше не придется заходить по ssh на сервер. Для просмотра логов я рекомендую gem 'tail'.
Приступим к использованию моего gem'a. В Gemfile добавяляем:

group :development do 
    gem 'capistrano' 
    gem 'capistrano3-ubuntu-server-prepare' 
end

Выполняем bundle install, cap install, добавляем строчку

require 'capistrano3/ubuntu-server-prepare'

в Capfile.

Практически все готово к работе. За исключением одного: для настройки Nginx и Redis мой скрипт берет .conf файлы из папок config/production/nginx и config/production/redis. Чтобы быстро скопировать мои конфигурационный файлы в эти папки, просто выполните:

rake ubuntu_server_prepare:copy_config

Бонусом также получаете настроенный конфиг Unicorn. В папке nginx лежат два файла: nginx.conf и nginx_with_pagespeed.conf. Второй используется при выборе установки pagespeed в конфигураторе.

Внимание! мой конфигурационный файл Nginx и Unicorn! настроен на Rails приложение, которое находится в '/var/www/application/current'. Измените все пути в этих файлах или просто добавьте строчку

set :application, 'application'

в Ваш deploy.rb для деплоя в эту папку.

В 'config/deploy/production.rb' необходимо прописать Ваш сервер, а также проследить, чтобы в Capfile строчка

require 'capistrano/rvm'

была закомментирована.

Теперь приступаем к самому вкусному:

cap production ubuntu_server_prepare

Конфигуратор задаст Вам много вопросов, получив ответы на которые, займется настройкой сервера. Этот процесс в меру долгий, так что можно пойти попить кофе.

Есть возможность запускать отдельные таски, например, выполнив

cap production ubuntu_server_prepare:nginx_conf

вы скопируете конфигурационный файл nginx.conf на сервер и перезагрузите nginx. Это удобно, чтобы быстро менять конфиг: поменяли что-то прямо в папке проекта и отправили на сервер одной командой.

gem 'capistrano3-git-push'

Маленький таск для Capistrano 3, выполняющий

git add -A
git commit -m "#{сообщение}"
git push

только в случае, если есть изменения. Если ввести «skip» в поле для запроса сообщения о коммите, то ничего не будет выполнено, что удобно, когда надо сделать deploy, но заливать в репозиторий изменения не надо.
Подключить проще простого. В Gemfile:

group :development do
	gem 'capistrano3-git-push'
end

В Capfile:

require 'capistrano3/git-push'

В deploy.rb:

before :deploy, 'git:push'

Моя текущая конфигурация Capistrano

Если вспомнить мою предыдущую статью, то мой deploy.rb был просто огромен. Теперь же моя конфигурация проста до безумия.

group :development do
	gem 'capistrano'
	gem 'capistrano-rails'
	gem 'capistrano-bundler'
	gem 'capistrano3-unicorn'
	gem 'capistrano-rvm'
	gem 'capistrano3-ubuntu-server-prepare'
	gem 'capistrano3-delayed-job'
end

group :production do
	gem 'unicorn'
end

# Load DSL and set up stages
require 'capistrano/setup'
require 'capistrano/deploy'
require 'capistrano3/ubuntu-server-prepare'
require 'capistrano3/unicorn'
require 'capistrano3/git-push'
require 'capistrano/rvm'
require 'capistrano/bundler'
require 'capistrano/rails'

set :application, 'application'
set :repo_url, "#{ВАШ_АДРЕС_РЕПО}"
set :unicorn_config_path, "#{current_path}/config/production/unicorn/unicorn.rb"
set :linked_dirs, fetch(:linked_dirs, []).push('bin', 'log', 'tmp/pids', 'tmp/cache', 'tmp/sockets', 'vendor/bundle', 'public/system') # Строчка есть по умолчанию в deploy.rb, ее просто надо откомментировать
namespace :deploy do
  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
  task :restart do
    invoke 'unicorn:legacy_restart'
  end
end
before :deploy, 'git:push'
before 'deploy:setup', 'git:push'

То есть сначала надо выполнить все то, что я описывал в начале статьи, затем один раз выполнить

cap production deploy:setup

для создания базы данных. Все последующие разы выполняем

cap production deploy

Стоит наверное объяснить, что тут происходит.

set :unicorn_config_path, "#{current_path}/config/production/unicorn/unicorn.rb"

set :linked_dirs, fetch(:linked_dirs, []).push('bin', 'log', 'tmp/pids', 'tmp/cache', 'tmp/sockets', 'vendor/bundle', 'public/system')

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

 task :restart do
    invoke 'unicorn:legacy_restart'
  end

P.S. Если используете resque, стоит посмотреть на gem 'capistrano-resque', если используете delayedjob, стоит посмотреть на gem 'capistrano3-delayed-job'.

Автор: goooseman

Источник