環境

$ cat /etc/system-release
Amazon Linux AMI release 2018.03

# プロジェクトのディレクトリ内にて
$ vim Gemfile.lock
capistrano (3.11.0)
unicorn (5.5.0)

$ rbenv versions
* 2.6.2 (set by /usr/local/rbenv/version)

$ bin/rails -v
Rails 5.2.3

はじめに

開発環境やステージング環境などデプロイ先によって、設定ファイル名はそれぞれstaging.rbやdevelopment.rbになると思います。
今回はproduction.rbという本番環境の設定ファイルを使用して、デプロイ・ロールバックするという前提で話を進めます。

production.rb

server 'localhost', user: 'banri', roles: %w{ app web db }
set :rails_env, :production
set :unicorn_rack_env, "#{fetch(:rails_env)}"
set :deploy_to, '/var/www/hogehoge（アプリケーション名）/production'
set :repo_url, 'git@github.com:banri/hogehoge.git'
set :branch, :master

デプロイ🚀

デプロイの疎通確認🔎

$ bundle exec cap production deploy:check

以下のような結果になれば、デプロイ疎通OKです。

$ bundle exec cap production deploy:check
00:00 git:wrapper
      01 mkdir -p /tmp
    ✔ 01 banri@localhost 0.751s
      Uploading /tmp/git-ssh-Hogehoge-local-banri.sh 100.0%
      02 chmod 700 /tmp/git-ssh-Hogehoge-local-banri.sh
    ✔ 02 banri@localhost 0.754s
00:02 git:check
      01 git ls-remote git@github.com:banri/hogehoge.git HEAD
      01 Warning: Permanently added 'github.com,XX.XX.XXX.XX' (RSA) to the list of known hosts.
      01 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx	HEAD
    ✔ 01 banri@localhost 2.833s
00:05 deploy:check:directories
      01 mkdir -p /var/www/hogehoge/production/shared /var/www/hogehoge/production/releases
    ✔ 01 banri@localhost 0.706s
00:05 deploy:check:linked_dirs
      01 mkdir -p /var/www/hogehoge/production/shared/log /var/www/hogehoge/production/shared/tmp/pids /var/www/hogehoge/production/shared/tmp/cache /var/www/hogehoge/production/shared/tmp/sockets /var/www/hoge…
    ✔ 01 banri@localhost 0.745s
00:06 deploy:check:make_linked_dirs
      01 mkdir -p /var/www/hogehoge/production/shared/config
    ✔ 01 banri@localhost 0.760s

CapistranoのデプロイはSSHを使用します。接続ができずデプロイの疎通に失敗した場合は、以下のようなエラーを吐きます。

cap aborted!
SSHKit::Runner::ExecuteError: Exception while executing as banri@localhost: Authentication failed for user banri@localhost

Caused by:
Net::SSH::AuthenticationFailed: Authentication failed for user banri@localhost

SSHのセットアップなどに関しては、Connecting to GitHub with SSHを参考にしてください。

デプロイの実行🚀🚀🚀

$ bundle exec cap production deploy

Capistranoの公式ドキュメントによると、上記コマンド1発で以下のコマンドが順番に実行されているそうです。

$ bundle exec cap production deploy:starting     - デプロイスタート+全てのデプロイ準備ができているかの確認
$ bundle exec cap production deploy:started      - custom tasksへのデプロイフックの作成開始
$ bundle exec cap production deploy:updating     - 新リリースに伴うサーバーのアップデート → ここではcurrentディレクトリに同期されていない状態
$ bundle exec cap production deploy:updated      - デプロイフックのアップデート
$ bundle exec cap production deploy:publishing   - 新リリースの公開
$ bundle exec cap production deploy:published    - デプロイフックの公開
$ bundle exec cap production deploy:finishing    - デプロイ完了
$ bundle exec cap production deploy:finished     - デプロイフック作成完了

deploy:updatingのコマンド入力後、/releases以下を確認するとアプリケーションのバージョンが変わっていないことが分かります。
変わっていない場合は、本日の日付が入ったソースコードのディレクトリが存在しません。

$ cd /var/www/hogehoge/production/releases
$ ls -tl
total 20
drwxrwxr-x 16 banri banri 4096 Mar 15 05:57 20190315033559     - 最終更新のファイル名が本日の日付になっていないことを確認
drwxrwxr-x 15 banri banri 4096 Jan 12 03:58 20190112061458
drwxrwxr-x 14 banri banri 4096 Aug  3  2018 20180803054816
drwxrwxr-x 15 banri banri 4096 Jul  4  2018 20180704091354
drwxrwxr-x 14 banri banri 4096 Jul  4  2018 20180704082634

ロールバック🌀

1つ前のリリース状態へロールバック🌀

$ bundle exec cap production deploy:rollback

ロールバックも同様に、上記コマンド1発で以下のコマンドが順番に実行されているそうです。

$ bundle exec cap production deploy:starting
$ bundle exec cap production deploy:started
$ bundle exec cap production deploy:reverting              - 旧リリースへサーバーの巻き戻し
$ bundle exec cap production deploy:reverted               - デプロイフックの巻き戻し
$ bundle exec cap production deploy:publishing
$ bundle exec cap production deploy:published
$ bundle exec cap production deploy:finishing_rollback     - ロールバック完了
$ bundle exec cap production deploy:finished

特定のリリース状態にロールバック🌀🌀🌀

ROLLBACK_RELEASE=の後に、リリースのディレクトリ名を指定するだけです。

$ bundle exec cap production deploy:rollback ROLLBACK_RELEASE=リリースのディレクトリ名（日付）

例えば以下のような感じです。
$ bundle exec cap production deploy:rollback ROLLBACK_RELEASE=20190112061458