Capistrano3/基本

Capistrano3

&tag(Capistrano3/基本);

目次†[edit]

目次
関連ページ
参考情報
基本的な使用方法

↑

参考情報†[edit]

↑

基本的な使用方法†[edit]

以下bundle経由で使用する方法を説明する。

↑

V2からの移行†[edit]

互換性がないので作りなおさないといけない。
GemfileをCapistrano3用に変更し、
Capfile、config/deploy.rbを削除し、
以下のインストール移行の手順を実行する。

↑

設定値の違い†[edit]

:repositoryが:repo_urlに。
ssh_optionsの指定方法が。

↑

インストール†[edit]

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
```

↑

設定ファイルの作成†[edit]

プロジェクトフォルダに移動し、「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

↑

設定ファイルの編集†[edit]

↑

Capfile†[edit]

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の編集†[edit]

いきなり本番サーバーに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の編集†[edit]

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

↑

config/deploy.rbの編集†[edit]

デプロイに関する共通設定を記述する。以下は後述する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

↑

使用する†[edit]

↑

listタスクの実行†[edit]

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

↑

deployタスクの実行†[edit]

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

↑

マイグレーション実行†[edit]

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

↑

古いリリースの削除†[edit]

手動で削除する

bundle exec cap deploy:cleanup -s keep_releases=3

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

deploy.rbに追加

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

↑