capistrano_rails_recipes 0.1.22 → 0.1.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1c488d09d1f3388c6635d19bcfec34a4ca379555
-  data.tar.gz: d43b124ff57b9edcc09fc8091a5224fd06fadc00
+  metadata.gz: d54893e78d434d2f87d88feba28111e57b238cc9
+  data.tar.gz: 83e61b16c862acd66051fc896f3da26cb2362831
 SHA512:
-  metadata.gz: 39d73811df5c7d3f6ae1aeaa85a18c32c52fdbf79e65730f49e4efb8e058fefdf0eece6f53bef83973c8956046a477ac5f3cfb629e908f6d22011be029984122
-  data.tar.gz: 3e3cd64e79af57fa950c30c46b9ece8dc187fbca68cacd9206407c3f30d25f2ff79dd724a7571d3288ad4958b9aa1ac206cf53ead7e24dd49943f791a36b2c04
+  metadata.gz: e542e51886d21d212af19b102f1de08b76be0db788d622499e8b7351f4616192adb082a93b9c828d06381fa82577e6c7ed4ff962d54e7cead5ca3cb058c4e14a
+  data.tar.gz: 096c4c626d574b6903305327c107305b804d2195e407027862846f586e999fa6a561a2549ab1f235c794704664ec902fd3130f995248319f4e7a958d3d015b46

data/README.md

@@ -1,4 +1,4 @@
-# Evrone collection of Capistrano recipes
+# Capistrano recipes for Rails
 
 We deploy a lot of Rails applications and our developers have to solve similar problems each time during the deployment: how to run workers, how to generate crontab, how to precompile assets faster and so on. This collection of recipes helps us to solve them.
 
@@ -6,20 +6,29 @@ Recipe use:
 
 * [`foreman`][foreman] + [`foreman_export_runitu`][runitu] to generate runit scripts with the Procfile
 * [`whenever`][whenever] to generate crontab
-* [`unicorn`][unicorn] to run the application
+* [`nginx`][nginx] as proxy server 
 
-It also consider that you use *system wide rbenv* on the server.
+It also consider that you use *rbenv* on the server.
 
 ##Installation
 
-    gem 'capistrano_evrone_recipes', :require => false
+    gem 'capistrano_rails_recipes', :require => false
 
 Capfile example:
 
-    require "capistrano_evrone_recipes/capistrano"
+    require "capistrano_rails_recipes/capistrano"
 
     set :repository, "git@github.com:..."
-    set :application, "my_cook_application"
+    set :application, "my_application"
+    set :user, 'deploy'
+    set :branch, 'master'
+    set :deploy_to, "/path/to/app"
+    set :use_sudo, false
+
+    server 'web.example.com', :web, :app, :worker, :crontab
+    role :db, 'web.example.com', primary: true
+
+    OR
 
     task :production do
       role  :web,     "web.example.com"
@@ -35,6 +44,14 @@ Capfile example:
 
 As you can see, we use use roles to bind the tasks, and there are some additions to roles and additional roles:
 
+**deploy:setup** creates all necessary folders and symlinks to files:
+    config/nginx.conf                     -> /opt/nginx/conf/sites-enabled/my_application
+    creates deploy_to/shared/config folder
+    creates deploy_to/services folder
+    copies config/database.example.yml    -> shared/config/database.yml
+
+Run **deploy:setup** before your first deploy. See below how to configure services.
+
 **web** compiles assets if content of `app/assets` was changed since last deploy (add FORCE=1 to force the assets compilation)
 
 **app** all files from `shared/config` is being symlinked to `current/config` like:
@@ -48,7 +65,7 @@ As you can see, we use use roles to bind the tasks, and there are some additions
 
 **worker** Procfile exports runit configs to `deploy_to/application/services`
 
-On **deploy:restart** unicorn and runit workers is being restarted.
+On **deploy:restart** runit workers is being restarted.
 
 You can use some extra `cap` tasks:
 
@@ -60,6 +77,63 @@ You can use some extra `cap` tasks:
 
 To run succesfully together with system wide rbenv, all you tasks in Procfile must be started with `rbenv exec`
 
+##Configuring services
+
+To run services just create Procfile in root of your app.
+
+Procfile example:
+
+    sidekiq: rbenv exec bundle exec sidekiq -L sidekiq.log
+    web: rbenv exec bundle exec unicorn -c config/unicorn.rb -E production
+
+Also you need to configure runit to monitor deploy_to/services folder. 
+
+##Nginx config file example for Unicorn
+
+    upstream unicorn_my_application {
+      server unix:/tmp/unicorn.my_application.sock fail_timeout=0;
+    }
+
+    server {
+      listen 80;
+      server_name web.example.com;
+      root deploy_to/current/public;
+
+      location ^~ /assets/ {
+        gzip_static on;
+        expires max;
+        add_header Cache-Control public;
+      }
+
+      try_files $uri/index.html $uri @unicorn;
+      location @unicorn {
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header Host $http_host;
+        proxy_redirect off;
+        proxy_pass http://unicorn_my_application;
+      }
+
+      error_page 500 502 503 504 /500.html;
+      client_max_body_size 4G;
+      keepalive_timeout 10;
+    }
+
+Change **deploy_to** and **my_application** to your actual values.
+
+##Unicorn config file example
+
+    root = "deploy_to/current"
+    working_directory root
+    pid "#{root}/tmp/pids/unicorn.pid"
+    stderr_path "#{root}/log/unicorn.log"
+    stdout_path "#{root}/log/unicorn.log"
+
+    listen "/tmp/unicorn.my_application.sock"
+    worker_processes 5
+    timeout 30
+
+Change **deploy_to** and **my_application** to your actual values.
+
 ##Capistrano
 
 Default variables:
@@ -90,3 +164,4 @@ To enable silent mode, add `ENV['CAP_SILENT_MODE']` before the `require 'capistr
 [runitu]: https://github.com/evrone/foreman_export_runitu
 [whenever]: https://github.com/javan/whenever
 [unicorn]: http://unicorn.bogomips.org/
+[nginx]: http://nginx.org/

data/lib/capistrano_rails_recipes/version.rb

@@ -3,7 +3,7 @@ module CapistranoRailsRecipes
 
     MAJOR = 0
     MINOR = 1
-    PATCH = 22
+    PATCH = 23
 
     def self.to_s
       "#{MAJOR}.#{MINOR}.#{PATCH}"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: capistrano_rails_recipes
 version: !ruby/object:Gem::Version
-  version: 0.1.22
+  version: 0.1.23
 platform: ruby
 authors:
 - Dmitry Galinsky