No commit activity in last 3 years
No release in over 3 years
A dangerous recipe that overwrites your running application.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

Runtime

 Project Readme

capistrano-redeploy

A dangerous recipe that overwrites your running application.

Installation

Add this line to your application's Gemfile:

gem 'capistrano-redeploy'

And then execute:

$ bundle

Or install it yourself as:

$ gem install capistrano-redeploy

Usage

THIS RECIPE MAY CORRUPT YOUR RUNNING APPLICATION. TAKE SPECIAL CARE FOR YOUR CONFIGURATION/OPERATION.

The capistrano-redeploy will try to perform following actions.

  1. Deploy application to temporary directory on remote servers
  2. Copy sources from temporary directory to running application

To enable capistrano-redeploy, add require line in your config/deploy.rb.

# config/deploy.rb
require "capistrano-redeploy"

Then, you can overwrite running application. By default, files in public will be overwritten on redeployment.

% cap redeploy

There are some options to configure redeployment for your application.

  • :redeploy_path - The directory to redeploy to. Use :current_release by default.
  • :redeploy_children - The list of directories to redeploy. Use ["public"] by default.
  • :redeploy_exclusions - The exclude list for redeployment. Use ["assets", "system"] by default.
  • :redeploy_variables - Supplimental variables for redeployment. See Examples for usage.
  • :redeploy_use_assets - Invoke assets:precompile after redeploy. Disabled by default.

Examples

Redeploy files from repository

Redeploy files in public (except public/assets and public/system) from external repository.

# config/deploy.rb
set :scm, :git
set :deploy_via, :copy
set :repository, "git://example.com/example.git"
set :redeploy_children, ["public"]
set :redeploy_exclusions, ["assets", "system"]

Redeploy files from local path

Redeploy files in public (except public/assets and public/system) from current directory.

# config/deploy.rb
set :scm, :git
set :deploy_via, :copy
set :repository, "git://example.com/example.git"
set :redeploy_variables, {
  :scm => :none,
  :deploy_via => :copy,
  :repository => ".", # redeploy from current directory
}
set :redeploy_children, ["public"]
set :redeploy_exclusions, ["assets", "system"]

Redeploy files from local path with different names

Redeploy files in src/main/webapp from current directory to target/webapp/WEB-INF.

# config/deploy.rb
set :scm, :git
set :deploy_via, :copy
set :repository, "git://example.com/example.git"
set :redeploy_variables, {
  :scm => :none,
  :deploy_via => :copy,
  :repository => ".", # redeploy from current directory
  :copy_cache => nil,
}
set :redeploy_source, "src/main/webapp"
set :redeploy_destination, "target/webapp/WEB-INF"
set :redeploy_children, ["."]
set :redeploy_exclusions, ["WEB-INF/web.xml"]

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Author

License

MIT