Capistrano3/基本の履歴(No.1)

Gemfileを編集し以下を追加。基本は"capistrano"だけだが、railsの処理を行ったり、rbenvの処理を行ったり、bundleを実行したりする場合追加のgemが必要となる。
```
group :deployment do
  gem 'capistrano'
  gem 'capistrano-rails'
  gem 'capistrano-rbenv'
  gem 'capistrano-bundler'
end
```
gemのインストール
```
bundle install --path vendor/bundle
```

↑

設定ファイルの作成†

プロジェクトフォルダに移動し、「cap install」を実行

 $ cd myproject
 $ bundle exec cap install
mkdir -p config/deploy
create config/deploy.rb
create config/deploy/staging.rb
create config/deploy/production.rb
mkdir -p lib/capistrano/tasks
Capified

↑

設定ファイルの編集†

↑

Capfile†

Capfileでは使用するモジュールをrequireする。他のファイルでrequireしてもうまくいかなかったりするの注意。

# Load DSL and Setup Up Stages
require 'capistrano/setup'

# Includes default deployment tasks
require 'capistrano/deploy'

# Includes tasks from other gems included in your Gemfile
#
# For documentation on these, see for example:
#
#   https://github.com/capistrano/rvm
#   https://github.com/capistrano/rbenv
#   https://github.com/capistrano/chruby
#   https://github.com/capistrano/bundler
#   https://github.com/capistrano/rails
#
# require 'capistrano/rvm'
require 'capistrano/rbenv'
# require 'capistrano/chruby'
require 'capistrano/bundler'
require 'capistrano/rails/assets'
#require 'capistrano/rails/migrations'

# Loads custom tasks from `lib/capistrano/tasks' if you have any defined.
Dir.glob('lib/capistrano/tasks/*.rake').each { |r| import r }

↑

config/deploy/staging.rbの編集†

いきなり本番サーバーにdeployするのは危険性が高い。テスト用の環境にデプロイするためstaging.rbを準備する。

server 'centos6vm', user: 'tanaka', roles: %w{app db web}, my_property: :my_value

role :app, %w{tanaka@centos6vm}
role :web, %w{tanaka@centos6vm}
role :db,  %w{tanaka@centos6vm}

↑

config/deploy/production.rbの編集†

production環境に関する設定を行う。role、server、ssh_optionsの設定あたり。

↑

config/deploy.rbの編集†

デプロイに関する共通設定を記述する。以下は後述するcopy_to_deployを実行する設定。

デプロイだけだとデバッグが大変なのでリモートで"ls"を実行する「list」タスクを定義しておくと便利。

set :application, 'demoapp'
set :rbenv_ruby, File.read('.ruby-version').strip
set :scm, :copy
set :tar_roles, :web
set :exclude_dir, ['vendor/bundle']
set :bundle_flags, '--quiet'

task :list  do
  on roles(:web) do
    execute "ls"
  end
end

namespace :deploy do
  namespace :deploy do
    after :restart, :restart_passenger do
      on roles(:web), in: :groups, limit: 3, wait: 10 do
	within release_path do
          execute :touch, 'tmp/restart.txt'
	end
      end
    end
    after :finishing, 'deploy:restart_passenger'
  end
end

↑

使用する†

↑

listタスクの実行†

サーバー上で"ls"を実行するlistタスクを実行してみる
```
bundle exec cap staging list
```

↑

deployタスクの実行†

サーバー上にdeployする
```
bundle exec cap staging deploy
```

↑

マイグレーション実行†

Capfileを編集し以下を追加する
```
require 'capistrano/rails/migrations'
```
Capistrano の db ロール - akishin999の日記によるとroleで:db指定がないといけないような雰囲気だが特にかかなくてもdeployでマイグレーションが自動実行された。
手動で実行する場合以下を呼ぶ
```
bundle exec cap staging deploy:migrate
```

↑

古いリリースの削除†

手動で削除する

bundle exec cap deploy:cleanup -s keep_releases=3

デプロイ後自動で削除する

deploy.rbに追加

set :keep_releases, 3
after :finishing, 'deploy:restart_passenger', 'deploy:cleanup'

Capistrano3/基本 の履歴(No.1)

目次†

関連ページ†

参考情報†

基本的な使用方法†

V2からの移行†

設定値の違い†

インストール†