Самый простой 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 '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 был просто огромен. Теперь же моя конфигурация проста до безумия.

Gemfile

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

Capfile

# 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'

deploy.rb

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"

Задает местоположения конфига unicorn для gem'а 'capistrano3-unicorn'.

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

Создает симлинки на указанные папки из папки current в папку shared.

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

Вызывает таск :create_db, перед выполнением 'db:migrate' при первом деплое (deploy:setup).

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

Тот самый таск :create_db, который вызывает 'rake db:create' при первом деплое.

 task :restart do
    invoke 'unicorn:legacy_restart'
  end

перезапускаем unicorn при каждом деплое.

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

This entry passed through the Full-Text RSS service - if this is your content and you're reading it on someone else's site, please read the FAQ at http://ift.tt/jcXqJW.

Want something else to read? How about 'Grievous Censorship' By The Guardian: Israel, Gaza And The Termination Of Nafeez Ahmed's Blog