結局Node.jsアプリケーションのデプロイはどうすればいいの？ で
色々node.jsアプリのデプロイを考えたのですが、
やっぱりcapistranoが結構使いやすい気がしてきました。
デプロイ対象でリポジトリから直接ソースコードを落とせるならば
デプロイ専用のリポジトリを作成して、それをCIで実行するようにすればいいわけです。
capistrano3では、基本的なデプロイタスクがあり、
それに独自のタスクを追加することで、様々な状況に対応しています。
どのようなタスクが実行されているかを把握できれば、柔軟にデプロイ設定が出来ます。
capistrano3をまず使ってみる
--dry-run で動くこと確認
$ gem install capistrano
$ 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
$ cap staging deploy --dry-run
** Invoke staging (first_time)
** Execute (dry run) staging
** Invoke deploy (first_time)
** Execute (dry run) deploy
capistrano3のデプロイフロー
capistrano3では、まず capistrano/setup と capistrano/deploy を
基本利用することになります。
それを軸にして、各タスクの前後に処理を記載すればその設定に合わせて実行してくれます。
なので、デプロイの流れを把握すればいいわけです。
capistrano/deployのフロー
deploy:starting
deploy:check
#{scm}:check
deploy:check:directories
deploy:check:linked_dirs
deploy:check:make_linked_dirs
deploy:check:linked_files
deploy:set_previous_revision
deploy:started
deploy:updating
#{scm}:create_release
deploy:symlink:shared
deploy:symlink:linked_files
deploy:symlink:linked_dirs
deploy:updated
deploy:publishing
deploy:symlink:release
deploy:published
deploy:finishing
deploy:cleanup
deploy:finished
deploy:log_revision
各プラグインのフロー
capistrano3ではすでによく使う状況については、プラグインが提供されています。
なので、Capfileでrequire capistrano/rails/assetsと記載するだけで
組み込むことが出来ます。
これらのプラグインを見ると、capistranoの独自のタスクの作り方が大体わかります。
capistrano/rails/assets
deploy:updatedの後に、assets::precompileの処理を行っています。
deploy:starting
deploy:check
#{scm}:check
deploy:check:directories
deploy:check:linked_dirs
deploy:check:make_linked_dirs
deploy:check:linked_files
deploy:set_previous_revision
deploy:started
deploy:updating
#{scm}:create_release
deploy:symlink:shared
deploy:symlink:linked_files
deploy:symlink:linked_dirs
deploy:updated
deploy:compile_assets # 追加
deploy:assets:precompile # 追加
deploy:assets:backup_manifest # 追加
deploy:normalize_assets # 追加
deploy:publishing
deploy:symlink:release
deploy:published
deploy:finishing
deploy:cleanup
deploy:finished
deploy:log_revision
capistrano/rails/migrations
deploy:updatedの後に、deploy:migrateの処理を行っています。
deploy:starting
deploy:check
#{scm}:check
deploy:check:directories
deploy:check:linked_dirs
deploy:check:make_linked_dirs
deploy:check:linked_files
deploy:set_previous_revision
deploy:started
deploy:updating
#{scm}:create_release
deploy:symlink:shared
deploy:symlink:linked_files
deploy:symlink:linked_dirs
deploy:updated
deploy:migrate # 追加
deploy:publishing
deploy:symlink:release
deploy:published
deploy:finishing
deploy:cleanup
deploy:finished
deploy:log_revision
capistrano/npm
この場合deploy:updatedの前にnpm:installを実行しています。
deploy:starting
deploy:check
#{scm}:check
deploy:check:directories
deploy:check:linked_dirs
deploy:check:make_linked_dirs
deploy:check:linked_files
deploy:set_previous_revision
deploy:started
deploy:updating
#{scm}:create_release
deploy:symlink:shared
deploy:symlink:linked_files
deploy:symlink:linked_dirs
npm:install # 追加
deploy:updated
deploy:publishing
deploy:symlink:release
deploy:published
deploy:finishing
deploy:cleanup
deploy:finished
deploy:log_revision
タスクの書き方
独自のタスクを書きたい場合は、lib/capistrano/tasks/ 以下に記載するのが通常です。
書き方は、各プラグインを参考にすると良いと思います。
namespace :npm do
desc <<-DESC
# 省略
DESC
task :install do # npm:install タスクを作成
on roles fetch(:npm_roles) do
within fetch(:npm_target_path, release_path) do
execute :npm, 'install', fetch(:npm_flags)
end
end
end
before 'deploy:updated', 'npm:install' # deploy:updateの前に npm:install を実行する
# ...
end