README.md in capistrano-deploy_into_docker-0.2.0 vs README.md in capistrano-deploy_into_docker-0.2.1

@@ -1,47 +1,48 @@
 # capistrano-deploy\_into\_docker
 
 [![Gem Version](https://badge.fury.io/rb/capistrano-deploy_into_docker.svg)](https://badge.fury.io/rb/capistrano-deploy_into_docker)
 
-Mini support task file to deploy app into docker.
+Mini support task to deploy app into docker.
 
 ## Installation
 
 Add in your Gemfile;
 
 ```ruby
-gem 'capistrano-deploy_into_docker', '>= 0.2.0', group: :development
+gem 'capistrano-deploy_into_docker', '>= 0.2.1', group: :development
 ```
 
 ## HowTo: deploy your rails application into docker
 
-### Require task on Capfile
+### 1) Require task on Capfile
 
 Add following like to your Capfile;
 
 ```ruby
 require 'capistrano/deploy_into_docker'
 ```
 
 This just add `deploy_into_docker:commit` task.
 
-### Deploy setting
+### 2) Create new deploy setting for docker
 
-You need to set `::sshkit_backend` to `SSHKit::Backend::Docker`.
+You need to set `:sshkit_backend` to `SSHKit::Backend::Docker`.
 
 Here is an example for config/deploy/docker.rb;
 
 ```ruby
 set :sshkit_backend, SSHKit::Backend::Docker
 set :stage, :production
 set :branch, 'production'
-set :deploy_to, '/var/local/app'
-set :git_shallow_clone, 1
-fetch(:default_env).merge!(rails_env: :production, SECRET_KEY_BASE: 'dummy', DEVISE_SECRET_KEY: 'dummy')
+set :deploy_to, '/app'
+fetch(:default_env).merge!(rails_env: :production, RAILS_SERVE_STATIC_FILES: 1,
+			   SECRET_KEY_BASE: 'dummy', DEVISE_SECRET_KEY: 'dummy',
+			   DATABASE_URL: 'mysql2://0/must-be-overrided')
 
-fetch(:linked_dirs, []).clear
-fetch(:linked_files, []).clear
+set :linked_dirs, %w{log tmp/sockets public/system}
+Rake::Task["deploy:set_linked_dirs"].clear # Save assets on each releases dir (not under shared)
 
 server docker: {
     image: 'sugi/rails-base',
     commit: 'myapp-web',
   }, user: 'rails:rails', roles: %w{web app}
@@ -60,14 +61,14 @@
 
 ```ruby
 server docker: {
     image: 'sugi/rails-base:latest',
     commit: 'new-image-name:tag',
-  }, user: 'nobody:nogroup', roles: %w{web app}
+  }, user: 'rails:rails', roles: %w{web app}
 ```
 
-In addtion, you can add any options for "docker run". for example;
+In addtion, you can add any options for "docker run". For example;
 
 ```ruby
 server docker: {
     image: 'ruby:latest',
     commit: 'new-image-name:tag',
@@ -75,9 +76,72 @@
     network: 'my-net',
     dns: '8.8.8.8',
     dns_search: 'example.com',
     cap_add: ['SYS_NICE', 'SYS_RESOURCE'],
   }, user: 'nobody:nogroup', roles: %w{web app}
+```
+
+If you want to build multiple images, define servers for each role. For example;
+
+```ruby
+server docker: {
+  image: 'sugi/rails-base:2.3',
+  commit: 'myapp-web',
+  env: {
+    APP_SERVER_CMD: "exec bin/rails server puma"
+  }
+}, user: 'rails:rails', roles: :web
+
+server docker: {
+  image: 'sugi/rails-base:2.3',
+  commit: 'myapp-job',
+  env: {
+    APP_SERVER_CMD: "exec bin/delayed_job run"
+  }
+}, user: 'rails:rails', roles: :app
+```
+
+
+## Tips
+
+### Stop to run some tasks only in docker deploy stage
+
+Use `Rake::Task["target:name"].clear`, for example;
+
+```ruby
+Rake::Task["passenger:restart"].clear
+```
+
+You can stop to run any target by calling clear method in deploy/_stage-name_.rb.
+
+### Deploy as handy development test
+
+If you run docker on localhost, mount current source dir as docker volume to test purpose
+(Note: I do NOT suggest this tric to build production environment).
+
+For example;
+
+```ruby
+set :sshkit_backend, SSHKit::Backend::Docker
+set :stage, :development
+set :branch, 'master'
+set :deploy_to, '/app'
+fetch(:default_env).merge!(rails_env: :development,
+   SECRET_KEY_BASE: 'dummy', DEVISE_SECRET_KEY: 'dummy',
+   DATABASE_URL: 'mysql2://0/must-be-overrided'
+   )
+set :bundle_without, 'test'
+set :repo_url, '/src'        # <--------- Use source from mounted volume.
+
+fetch(:linked_dirs, []).clear
+fetch(:linked_files, []).clear
+Rake::Task["deploy:set_linked_dirs"].clear
+
+server docker: {
+  image: 'nvc-base',
+  commit: 'nvc-test',
+  volume: "#{Dir.pwd}:/src",  # <---------- Mount current source as docker volume.
+}, user: 'rails:rails', roles: %w{web app}
 ```
 
 ## Copyright
 
 Author: Tatsuki Sugiura