capistrano-mb 0.22.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 636468db9344486d693871a6cd9f863ae6adaa4b
+  data.tar.gz: cc71034d8dedf94388b96ad5c254f08ee1a67ecd
+SHA512:
+  metadata.gz: 109be86d154b0e2d8eed01a3d79ac9deae7f2d246733d036773330c49d12e926ccb249e87c8223cac35b99702fe5db1eb9cee0dfc1a19d565ba6c555d9368c80
+  data.tar.gz: 52879fa492ce9ac58c5b98c7a4a0f3b1f9d34f5ad3d088d170c6ac837cc42fc24ecb0f8998fb848467a025be0e02d0fb9e02ef4d0596fbef87fb7be5fc793542

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/CHANGELOG.md

@@ -0,0 +1,114 @@
+## Next release
+
+* Your contribution here!
+
+## 0.22.0 (2015-06-22)
+
+**THIS GEM HAS A NEW NAME! It is now `capistrano-mb`.**
+
+* All settings now use the `mb_` prefix. E.g. if you are using `set(:fiftyfive_recipies, ...)`, change it to `set(:mb_recipes, ...)`.
+* All tasks now use the `mb` namespace. E.g. `cap fiftyfive:crontab` is now `cap mb:crontab`.
+* For backwards compatibility, you can still use the `fiftyfive` versions, but a deprecation warning will be printed. This compatibility will be removed in capistrano-mb 1.0.
+
+## 0.21.0 (2015-06-22)
+
+* Add a post-install message explaining the rename of `capistrano-fiftyfive` to `capistrano-mb`.
+
+## 0.20.1 (2015-05-29)
+
+* An internal change in Capistrano 3.4.0 caused `fiftyfive:aptitude:install` to fail to install packages. This is now fixed.
+
+## 0.20.0 (2015-05-29)
+
+* Increase SSL/TLS security of the generated nginx configuration by following the suggestions of [weakdh.org](https://weakdh.org/sysadmin.html).
+
+## 0.19.0 (2015-04-10)
+
+* Add `--retry=3` to bundle install options. This will help prevent deployment failures in case that a gem initially fails to download during the `bundle install` step.
+* Ensure that `--dry-run` works without crashing. This involved working around Capistrano's `download!` behavior (it returns a String normally, but an entirely different object during a dry run).
+
+## 0.18.0
+
+* **The abbreviated log formatter has been removed and is now available in a new gem: `airbrussh`.** With this change, capistrano-fiftyfive no longer automatically changes the logging format of capistrano. To opt into the prettier, more concise format, add the airbrussh gem to your project as explained in the [airbrussh README](https://github.com/mattbrictson/airbrussh#readme).
+* The version initializer that capistrano-fiftyfive adds during deployment sets a new value: `Rails.application.config.version_time`. You can use this value within your app for the date and time of the last commit that produced the version that is currently deployed.
+
+
+## 0.17.2
+
+* Default self-signed SSL certificate is now more generic (for real this time).
+
+## 0.17.1
+
+* Cosmetic changes to the gemspec.
+
+## 0.17.0
+
+* Write a banner message into `capistrano.log` at the start of each cap run, to aid in troubleshooting.
+* Default self-signed SSL certificate is now more generic.
+
+## 0.16.0
+
+* capistrano-fiftyfive now requires capistrano >= 3.3.5 and sshkit => 1.6.1
+* `ask_secretly` has been removed in favor of Capistrano's built-in `ask ..., :echo => false`
+* `agree` no longer takes an optional second argument
+* highline dependency removed
+* Install libffi-dev so that Ruby 2.2.0 can be compiled
+
+## 0.15.2
+
+* The capistrano-fiftyfive GitHub repository has changed: it is now <https://github.com/mattbrictson/capistrano-fiftyfive>.
+
+## 0.15.1
+
+* Remove `-j4` bundler flag
+
+## 0.15.0
+
+* Dump useful troubleshooting information when a deploy fails.
+* Nginx/unicorn: fix syntax errors introduced by changes in 0.14.0, ensuring that gzip and far-future expires headers are sent as expected.
+
+## 0.14.0
+
+* The `highline` gem is now a dependency ([#3](https://github.com/mattbrictson/capistrano-fiftyfive/pull/3) from [@ahmozkya](https://github.com/ahmozkya)).
+* Dotenv: only mask input when prompting for keys containing the words "key", "secret", "token", or "password". Input for other keys is echoed for easier data entry.
+* Dotenv: update `.env` files in sequence rather than in parallel, to avoid parallel command output clobbering the input prompt.
+* Nginx/unicorn: tweak reverse-proxy cache settings to prevent cache stampede.
+* Nginx/unicorn: apply far-future expires cache headers only for assets that have fingerprints.
+
+## 0.13.0
+
+The provisioning tasks now work for a non-root user that has password-less sudo privileges. Assuming a user named `matt` that can sudo without being prompted for a password ([instructions here](http://askubuntu.com/questions/192050/how-to-run-sudo-command-with-no-password)), simply modify `deploy.rb` with:
+
+```ruby
+set :fiftyfive_privileged_user, "matt"
+```
+
+Now all provisioning tasks that would normally run as root will instead run as `matt` using `sudo`.
+
+## 0.12.0
+
+* capistrano-fiftyfive's abbreviated format now honors the new `SSHKIT_COLOR` environment variable. Set `SSHKIT_COLOR=1` to force ANSI color even on non-ttys (e.g. Jenkins).
+* The generated nginx config now enables reverse proxy caching by default.
+* INFO messages printed by sshkit are now printed to console under the appropriate rake task heading.
+
+## 0.11.1
+
+Fixes errors caused by PostgreSQL password containing shell-unsafe characters. Passwords are now safely hashed with MD5 before being used in the `CREATE USER` command.
+
+## 0.11.0
+
+* INFO log messages are now included in abbreviated output (e.g. upload/download progress).
+* Add `agree()` method to the DSL, which delegates to `HighLine.new.agree`.
+* Add `fiftyfive:postgresql:dump`/`restore` tasks.
+
+## 0.10.0
+
+Add support for Ubuntu 14.04 LTS. To provision a 14.04 server, use the new `provision:14_04` task.
+
+## 0.9.1
+
+Flush console output after each line is printed. This allows deployment progress to be monitored in e.g. Jenkins.
+
+## 0.9.0
+
+Initial Rubygems release!

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in capistrano-mb.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 55 Minutes Inc
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,173 @@
+# capistrano-mb
+
+[![Gem Version](https://badge.fury.io/rb/capistrano-mb.svg)](http://badge.fury.io/rb/capistrano-mb)
+
+Capistrano is great for deploying Rails applications, but what about all the prerequisites, like Nginx and PostgreSQL? Do you have a firewall configured on your VPS? Have you installed the latest OS security updates? Is HTTPS working right?
+
+The capistrano-mb gem adds a `cap <stage> provision` task to Capistrano that takes care of all that. Out of the box, `provision` will:
+
+* Install the latest `postgresql`, `node.js`, and `nginx` apt packages
+* Install all libraries needed to build Ruby
+* Lock down your VPS using `ufw` (a simple front-end to iptables)
+* Set up `logrotated` for your Rails logs
+* Schedule an automatic daily backup of your Rails database
+* Generate a self-signed SSL certificate if you need one
+* Set up ngnix with the latest SSL practices and integrate it with Unicorn for your Rails app
+* Create the `deployer` user and install an SSH public key
+* Install `rbenv` and use `ruby-build` to compile the version of Ruby required by your app (by inspecting your `.ruby-version` file)
+* And more!
+
+The gem is named "capistrano-mb" because it is prescribes my ([@mattbrictson](https://github.com/mattbrictson)) personal preferences for automating deployments of Rails projects. I'm a freelance developer juggling lots of Rails codebases, so its important for me to have a good, consistent server configuration. You'll notice that capistrano-mb is opinionated and strictly uses the following stack:
+
+* Ubuntu 12.04 LTS or 14.04 LTS
+* PostgreSQL
+* Unicorn
+* Nginx
+* rbenv
+* dotenv
+
+In addition, capistrano-mb changes many of Capistrano's defaults, including the deployment location, Bundler behavior, and SSH keep-alive settings. (See [defaults.rake][] for details.)
+
+Not quite to your liking? Consider forking the project to meet your needs.
+
+
+## Installation
+
+Please note that this project requires **Capistrano 3.x**, which is a complete
+rewrite of Capistrano 2.x. The two major versions are not compatible.
+
+### 1. Gemfile
+
+Add these gems to the development group of your Rails application's Gemfile:
+
+    group :development do
+      gem 'capistrano-bundler', :require => false
+      gem 'capistrano-rails', :require => false
+      gem 'capistrano', '~> 3.4.0', :require => false
+      gem 'capistrano-mb' :require => false
+    end
+
+And then execute:
+
+    $ bundle
+
+
+### 2. cap install
+
+If your project doesn't yet have a `Capfile`, run `cap install` with the list
+of desired stages (environments):
+
+    cap install STAGES=staging,production
+
+
+### 3. Capfile
+
+Add these lines to the **bottom** of your app's `Capfile`
+(order is important!):
+
+    require 'capistrano/bundler'
+    require 'capistrano/rails'
+    require 'capistrano/mb'
+
+
+### 4. Choose which recipes to auto-run
+
+Most of the capistrano-mb recipes are designed to run automatically as part of `cap <stage> provision`, for installing and setting up various bits of the Rails infrastructure, like nginx, unicorn, and postgres. Some recipes also contribute to the `cap <stage> deploy` process.
+
+*This auto-run behavior is fully under your control.*  In your `deploy.rb`,
+set `:mb_recipes` to an array of the desired recipes.
+If you don't want a recipe to execute as part of `deploy`/`provision`, simply omit it from
+the list.
+
+The following list will suffice for most out-of-the-box Rails apps. The order of the list is not important.
+
+    set :mb_recipes, %w(
+      aptitude
+      crontab
+      dotenv
+      logrotate
+      migrate
+      nginx
+      postgresql
+      rbenv
+      seed
+      ssl
+      ufw
+      unicorn
+      user
+      version
+    )
+
+Even if you don't include a recipe in the auto-run list, you can still invoke
+the tasks of those recipes manually at your discretion.
+
+
+### 5. Configuration
+
+Many of the recipes have default settings that can be overridden. Use your
+`deploy.rb` file to specify these overrides. Or, you can override per stage.
+Here is an example override:
+
+    set :mb_unicorn_workers, 8
+
+For the full list of settings and their default values, refer to
+[defaults.rake][].
+
+
+### A working example
+
+Check out our [rails-starter][] project for a sample Capfile and deploy.rb.
+
+## Usage
+
+The power of the capistrano-mb recipes is that they take care of the
+entire setup of a bare Ubuntu 12.04 or 14.04 server, all the way to a fully configured
+and running Rails app on top up Unicorn, Nginx, rbenv, and PostgreSQL.
+
+### Deploying to a new server from scratch
+
+These steps assume you have loaded the full set of capistrano-mb
+recipes in your Capfile.
+
+1. Provision an Ubuntu 12.04 or 14.04 VPS at your hosting provider of choice.
+2. Install your public SSH key for the root user. Some providers (e.g. DigitalOcean) can do this for you automatically when you provision a new VPS.
+3. Repeat steps 1-2 for all the servers in your cluster, if you are using
+   a multi-server setup (e.g. separate web, app, and database servers).
+4. Let capistrano-mb take it from here:
+
+        cap staging provision       # for 12.04 LTS
+        cap staging provision:14_04 # for 14.04 LTS
+        cap staging deploy
+
+### Running individual tasks
+
+For a full description of all available tasks, run:
+
+    cap -T
+
+All tasks from capistrano-mb will be prefixed with `mb:`. You
+can run these tasks just like any other capistrano task, like so:
+
+    cap staging mb:seed
+
+
+## History
+
+This gem used to be called capistrano-fiftyfive, because it was initially built by [55 Minutes](http://55minutes.com) to automate its Rails deployments. I have since taken over ownership of the gem and renamed it to capistrano-mb to avoid any confusion.
+
+If you are upgrading from `capistrano-fiftyfive`, refer to the [CHANGELOG entry for v0.22.0](CHANGELOG.md#0220-2015-06-22) for migration instructions.
+
+## 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
+
+
+[Postmark]:https://postmarkapp.com
+[cast337]:http://railscasts.com/episodes/337-capistrano-recipes
+[cast373]:http://railscasts.com/episodes/373-zero-downtime-deployment
+[defaults.rake]:lib/capistrano/tasks/defaults.rake
+[rails-starter]:https://github.com/mattbrictson/rails-starter/tree/master/config

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+require "chandler/tasks"
+
+# Add chandler as a prerequisite for `rake release`
+task "release:rubygem_push" => "chandler:push"

data/capistrano-mb.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "capistrano/mb/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "capistrano-mb"
+  spec.version       = Capistrano::MB::VERSION
+  spec.author        = "Matt Brictson"
+  spec.email         = "matt@mattbrictson.com"
+  spec.description   = \
+    "Production-ready provisioning and deployment recipes for the full "\
+    "Rails 4 stack. Installs and configures Ruby, Nginx, Unicorn, "\
+    "PostgreSQL, dotenv, and more onto Ubuntu 14.04 LTS using Capistrano. "\
+    "(Note: this gem was formerly called capistrano-fiftyfive.)"
+  spec.summary       = "Additional Capistrano 3 recipes"
+  spec.homepage      = "https://github.com/mattbrictson/capistrano-mb"
+  spec.license       = "MIT"
+
+  spec.post_install_message = "capistrano-fiftyfive has been renamed to "\
+                              "capistrano-mb. Please update your Gemfile."
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "capistrano", ">= 3.3.5"
+  spec.add_dependency "sshkit", ">= 1.6.1"
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "chandler"
+  spec.add_development_dependency "rake"
+end

data/lib/capistrano/fiftyfive.rb

@@ -0,0 +1,6 @@
+require "capistrano/mb"
+
+compatibility_warning(
+  "The capistrano-fiftyfive gem has been renamed to capistrano-mb. "\
+  'Use `require "capistrano/mb"` to ensure compatibility with future versions.'
+)

data/lib/capistrano/mb.rb

@@ -0,0 +1,29 @@
+require "digest"
+require "monitor"
+require "capistrano/mb/version"
+require "capistrano/mb/compatibility"
+require "capistrano/mb/dsl"
+require "capistrano/mb/recipe"
+include Capistrano::MB::DSL
+
+load File.expand_path("../tasks/provision.rake", __FILE__)
+load File.expand_path("../tasks/defaults.rake", __FILE__)
+load File.expand_path("../tasks/user.rake", __FILE__)
+load File.expand_path("../tasks/aptitude.rake", __FILE__)
+load File.expand_path("../tasks/ufw.rake", __FILE__)
+load File.expand_path("../tasks/ssl.rake", __FILE__)
+load File.expand_path("../tasks/dotenv.rake", __FILE__)
+load File.expand_path("../tasks/postgresql.rake", __FILE__)
+load File.expand_path("../tasks/nginx.rake", __FILE__)
+load File.expand_path("../tasks/unicorn.rake", __FILE__)
+load File.expand_path("../tasks/delayed_job.rake", __FILE__)
+load File.expand_path("../tasks/crontab.rake", __FILE__)
+load File.expand_path("../tasks/logrotate.rake", __FILE__)
+load File.expand_path("../tasks/rbenv.rake", __FILE__)
+load File.expand_path("../tasks/maintenance.rake", __FILE__)
+load File.expand_path("../tasks/migrate.rake", __FILE__)
+load File.expand_path("../tasks/seed.rake", __FILE__)
+load File.expand_path("../tasks/version.rake", __FILE__)
+load File.expand_path("../tasks/rake.rake", __FILE__)
+load File.expand_path("../tasks/sidekiq.rake", __FILE__)
+load File.expand_path("../tasks/fiftyfive.rake", __FILE__)

data/lib/capistrano/mb/compatibility.rb

@@ -0,0 +1,17 @@
+require 'colorize'
+
+unless defined?(Capistrano) && defined?(:namespace)
+  $stderr.puts\
+    "WARNING: capistrano/mb must be loaded by Capistrano in order "\
+    "to work.\nRequire this gem by using Capistrano's Capfile, "\
+    "as described here:\n"\
+    "https://github.com/mattbrictson/capistrano-mb#installation"\
+    .colorize(:red)
+end
+
+if Capistrano::VERSION == "3.2.0"
+  $stderr.puts\
+    "WARNING: Capistrano 3.2.0 has a critical bug that prevents "\
+    "capistrano-mb from working as intended:\n"\
+    "https://github.com/capistrano/capistrano/issues/1004".colorize(:red)
+end

data/lib/capistrano/mb/dsl.rb

@@ -0,0 +1,187 @@
+module Capistrano
+  module MB
+    module DSL
+
+      # Invoke the given task. If a task with that name is not defined,
+      # silently skip it.
+      #
+      def invoke_if_defined(task)
+        invoke(task) if Rake::Task.task_defined?(task)
+      end
+
+      # Used internally by capistrano-mb to register tasks such that
+      # those tasks are executed conditionally based on the presence of the
+      # recipe name in fetch(:mb_recipes).
+      #
+      #   mb_recipe :aptitude do
+      #     during :provision, %w(task1 task2 ...)
+      #   end
+      #
+      def mb_recipe(recipe_name, &block)
+        Recipe.new(recipe_name).instance_exec(&block)
+      end
+
+      def compatibility_warning(warning)
+        warning = "WARNING: #{warning}"
+        warning = warning.colorize(:red) if $stderr.tty?
+        $stderr.puts(warning)
+      end
+
+      # Helper for calling fetch(:application) and making the value safe for
+      # using in filenames, usernames, etc. Replaces non-word characters with
+      # underscores.
+      #
+      def application_basename
+        fetch(:application).to_s.gsub(/[^a-zA-Z0-9_]/, "_")
+      end
+
+      # Prints a question and returns truthy if the user answers "y" or "yes".
+      def agree(yes_or_no_question)
+        $stdout.print(yes_or_no_question)
+        $stdin.gets.to_s =~ /^y(es)?/i
+      end
+
+      # Like capistrano's built-in on(), but connects to the server as root.
+      # To use a user other than root, set :mb_privileged_user or
+      # specify :privileged_user as a server property.
+      #
+      #   task :reboot do
+      #     privileged_on roles(:all) do
+      #       execute :shutdown, "-r", "now"
+      #     end
+      #   end
+      #
+      def privileged_on(*args, &block)
+        on(*args) do |host|
+          if host.nil?
+            instance_exec(nil, nil, &block)
+          else
+            original_user = host.user
+
+            begin
+              host.user = host.properties.privileged_user ||
+                          fetch(:mb_privileged_user)
+              instance_exec(host, original_user, &block)
+            ensure
+              host.user = original_user
+            end
+          end
+        end
+      end
+
+      # Uploads the given string or file-like object to the current host
+      # context. Intended to be used within an on() or privileged_on() block.
+      # Accepts :owner and :mode options that affect the permissions of the
+      # remote file.
+      #
+      def put(string_or_io, remote_path, opts={})
+        sudo_exec = ->(*cmd) {
+          cmd = [:sudo] + cmd if opts[:sudo]
+          execute *cmd
+        }
+
+        tmp_path = "/tmp/#{SecureRandom.uuid}"
+
+        owner = opts[:owner]
+        mode = opts[:mode]
+
+        source = if string_or_io.respond_to?(:read)
+          string_or_io
+        else
+          StringIO.new(string_or_io.to_s)
+        end
+
+        sudo_exec.call :mkdir, "-p", File.dirname(remote_path)
+
+        upload!(source, tmp_path)
+
+        sudo_exec.call(:mv, "-f", tmp_path, remote_path)
+        sudo_exec.call(:chown, owner, remote_path) if owner
+        sudo_exec.call(:chmod, mode, remote_path) if mode
+      end
+
+
+      # Read the specified file from the local system, interpret it as ERb,
+      # and upload it to the current host context. Intended to be used with an
+      # on() or privileged_on() block. Accepts :owner, :mode, and :binding
+      # options.
+      #
+      # Templates with relative paths are first searched for in
+      # lib/capistrano/mb/templates in the current project. This gives
+      # applications a chance to override. If an override is not found, the
+      # default template within the capistrano-mb gem is used.
+      #
+      #   task :create_database_yml do
+      #     on roles(:app, :db) do
+      #       within(shared_path) do
+      #         template fetch(:database_yml_template_path),
+      #                  "config/database.yml",
+      #                  :mode => "600"
+      #       end
+      #     end
+      #   end
+      #
+      def template(local_path, remote_path, opts={})
+        binding = opts[:binding] || binding
+
+        unless local_path.start_with?("/")
+          override_path = \
+            File.join("lib/capistrano/mb/templates", local_path)
+
+          local_path = if File.exist?(override_path)
+            override_path
+          else
+            File.expand_path(File.join("../templates", local_path), __FILE__)
+          end
+        end
+
+        erb = File.read(local_path)
+        rendered_template = ERB.new(erb).result(binding)
+
+        put(rendered_template, remote_path, opts)
+      end
+    end
+  end
+end
+
+require "capistrano/dsl/env"
+
+module Capistrano
+  module DSL
+    module Env
+      # Overrides capistrano's default `set` to assist developers that are
+      # migrating from the `fiftyfive_*` to `mb_*` variable names. This will
+      # be removed in a future version of capistrano-mb.
+      alias_method :_orig_capistrano_set, :set
+      def set(name, *args, &block)
+        if name.to_s =~ /^fiftyfive_/
+          mb_name = name.to_s.gsub(/^fiftyfive_/, "mb_")
+          compatibility_warning(
+            "Use `set :#{mb_name}` instead of `set :#{name}` to ensure "\
+            "compatibility with future versions of capistrano-mb. The "\
+            "fiftyfive_* names have been deprecated."
+          )
+          name = mb_name.intern
+        end
+        _orig_capistrano_set(name, *args, &block)
+      end
+
+      # Overrides capistrano's default `fetch` to assist developers that are
+      # migrating from the `fiftyfive_*` to `mb_*` variable names. This will
+      # be removed in a future version of capistrano-mb.
+      alias_method :_orig_capistrano_fetch, :fetch
+      def fetch(name, *args, &block)
+        if name.to_s =~ /^fiftyfive_/
+          mb_name = name.to_s.gsub(/^fiftyfive_/, "mb_")
+          compatibility_warning(
+            "Use `fetch :#{mb_name}` instead of `fetch :#{name}` to ensure "\
+            "compatibility with future versions of capistrano-mb. The "\
+            "fiftyfive_* names have been deprecated."
+          )
+          name = mb_name.intern
+        end
+        _orig_capistrano_fetch(name, *args, &block)
+      end
+    end
+  end
+end