Ansible: Ruby on Rails Server (Ubuntu 16.x)
Use this ansible playbook to setup a fresh server with the following components:
- Nginx
- Puma App Server
- Certbot (Let's Encrypt)
- MySQL
- Memcached
- Redis
- Sidekiq
- Monit (to keep Puma and Sidekiq runnig)
- Elasticsearch
- ruby-install
- chruby
- Directories to deploy Rails with Capistrano and Puma App Server (see below)
- Swapfile (useful for small DO instances)
- Locales
- Tools (tmux, vim, htop, git, wget, curl etc.)
Prerequisites & Config
-
Rename
hosts.example
tohosts
and modify the contents. -
Rename
group_vars/all.example
togroup_vars/all
and modify the contentes.There are a bunch of things you can set in
group_vars/all
. Don't forget to add your host address tohosts
.
Install Playbook
Run ansible-playbook site.yml -i hosts
.
Rails Setup
This is just a loose guideline for what you need to deploy your app with this playbook and server config. Please keep in mind, that you need to modify some values depending on your setup (especially passwords and paths!)
Gemfile
Add the following gems to your Gemfile and install via bundle install
:
group :development do
gem 'capistrano', '~> 3.6'
gem 'capistrano-rails', '~> 1.2'
gem 'capistrano-chruby'
gem 'capistrano3-puma'
gem 'capistrano-sidekiq'
end
Capfile
Add the following lines to your Capfile:
# General
require 'capistrano/rails'
require 'capistrano/bundler'
require 'capistrano/rails/migrations'
require 'capistrano/rails/assets'
require 'capistrano/chruby'
# Puma
require 'capistrano/puma'
require 'capistrano/puma/workers'
require 'capistrano/puma/monit'
require 'capistrano/puma/nginx'
# Sidekiq
require 'capistrano/sidekiq'
require 'capistrano/sidekiq/monit'
config/deploy.rb
Please edit "deploy_app_name", "repo_url", "deploy_to" and "chruby_ruby" (if you've changed the Ruby version in group_vars/all
).
Your config/deploy.rb
should look similar to this example:
set :application, 'deploy_app_name'
set :repo_url, 'YOUR_GIT_REPO'
set :deploy_to, '/home/deploy/deploy_app_name'
set :chruby_ruby, 'ruby-2.3.3'
set :nginx_use_ssl, true
set :puma_init_active_record, true
set :linked_files, fetch(:linked_files, []).push('config/database.yml', 'config/secrets.yml')
set :linked_dirs, fetch(:linked_dirs, []).push('log', 'tmp/pids', 'tmp/cache', 'tmp/sockets', 'public/system')
set :keep_releases, 5
config/deploy/production.rb
Add the target host:
server 'your_host_address', user: 'deploy', roles: %w{app db web}
Feedback
Feel free to send feedback or report problems via GitHub issues!