README.md in capistrano-rails-1.3.1 vs README.md in capistrano-rails-1.4.0
- old
+ new
@@ -5,16 +5,16 @@
- `cap deploy:migrate`
- `cap deploy:compile_assets`
## Installation
-Add these lines to your application's Gemfile:
+Add these Capistrano gems to your application's Gemfile using `require: false`:
```ruby
group :development do
- gem 'capistrano', '~> 3.6'
- gem 'capistrano-rails', '~> 1.3'
+ gem "capistrano", "~> 3.10", require: false
+ gem "capistrano-rails", "~> 1.4", require: false
end
```
Run the following command to install the gems:
@@ -69,10 +69,14 @@
# Defaults to 'assets'
# This should match config.assets.prefix in your rails config/application.rb
set :assets_prefix, 'prepackaged-assets'
+# Defaults to ["/path/to/release_path/public/#{fetch(:assets_prefix)}/.sprockets-manifest*", "/path/to/release_path/public/#{fetch(:assets_prefix)}/manifest*.*"]
+# This should match config.assets.manifest in your rails config/application.rb
+set :assets_manifests, ['app/assets/config/manifest.js']
+
# RAILS_GROUPS env value for the assets:precompile task. Default to nil.
set :rails_assets_groups, :assets
# If you need to touch public/images, public/javascripts, and public/stylesheets on each deploy
set :normalize_asset_timestamps, %w{public/images public/javascripts public/stylesheets}
@@ -88,10 +92,10 @@
You'll probably want to symlink Rails shared files and directories like `log`, `tmp` and `public/uploads`.
Make sure you enable it by setting `linked_dirs` and `linked_files` options:
```ruby
# deploy.rb
-append :linked_dirs, 'log', 'tmp/pids', 'tmp/cache', 'tmp/sockets', 'vendor/bundle', 'public/system', 'public/uploads'
+append :linked_dirs, 'log', 'tmp/pids', 'tmp/cache', 'tmp/sockets', 'vendor/bundle', '.bundle', 'public/system', 'public/uploads'
append :linked_files, 'config/database.yml', 'config/secrets.yml'
```
In capistrano < 3.5, before `append` was introduced, you can use `fetch` and `push` to get the same result.