goooseman Dec 16 2014 at 19:28

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

5 min

30K

Tutorial

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

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

Tags:

Hubs: