eZ Publish meets Capistrano

Presented during the flash talk session at the eZUnConference 2012 in Cologne.

Gives a short feedback on how using Capistrano can be interesting when it comes to deploy eZ Publish application.

It also introduces AlCapON which is a bunch of Capistrano recipes made specially for eZ Publish (still an alpha/poc version)

Transcript

1. SECURE YOUR DEPLOYMENT WITH CAPISTRANO Arnaud Lafon - Freelance contact@arnaudlafon.com - @arnaudlafon jeudi 18 octobre 12
2. jeudi 18 octobre 12
3. CODE jeudi 18 octobre 12
4. CODE BUG FIX jeudi 18 octobre 12
5. CODE BUG FIX COMMIT jeudi 18 octobre 12
6. CODE BUG FIX COMMIT TEST OUR CODE jeudi 18 octobre 12
7. CODE BUG FIX COMMIT TEST OUR CODE TEST CODE FROM SOMEONE ELSE jeudi 18 octobre 12
8. CODE BUG FIX COMMIT TEST OUR CODE LAST MINUTE PATCHES TEST CODE FROM SOMEONE ELSE jeudi 18 octobre 12
9. CODE BUG FIX COMMIT TEST OUR CODE LAST MINUTE PATCHES TEST CODE FROM SOMEONE ELSE jeudi 18 octobre 12
10. jeudi 18 octobre 12
11. THAT SIMPLE ? jeudi 18 octobre 12
12. NOT REALLY .... jeudi 18 octobre 12
13. What DEPLOYMENT means ? jeudi 18 octobre 12
14. What DEPLOYMENT means ? IT HAS TO BE jeudi 18 octobre 12
15. What DEPLOYMENT means ? IT HAS TO BE as FAST as possible jeudi 18 octobre 12
16. What DEPLOYMENT means ? IT HAS TO BE as FAST as possible RELIABLE jeudi 18 octobre 12
17. What DEPLOYMENT means ? IT HAS TO BE as FAST as possible RELIABLE STABLE jeudi 18 octobre 12
18. What DEPLOYMENT means ? IT HAS TO BE as FAST as possible RELIABLE STABLE IT MUST jeudi 18 octobre 12
19. What DEPLOYMENT means ? IT HAS TO BE as FAST as possible RELIABLE STABLE IT MUST provide ROLLBACK FEATURES jeudi 18 octobre 12
20. What DEPLOYMENT means ? IT HAS TO BE as FAST as possible RELIABLE STABLE IT MUST provide ROLLBACK FEATURES deal with MULTIPLE ENVIRONMENTS jeudi 18 octobre 12
21. What DEPLOYMENT means ? IT HAS TO BE as FAST as possible RELIABLE STABLE IT MUST provide ROLLBACK FEATURES var/ FOLDERS take of your deal with MULTIPLE ENVIRONMENTS jeudi 18 octobre 12
22. What DEPLOYMENT means ? IT HAS TO BE as FAST as possible RELIABLE STABLE IT MUST provide ROLLBACK FEATURES var/ FOLDERS take of your deal with MULTIPLE ENVIRONMENTS OBVIOUSLY, YOU ONLY HAVE ONE PRODUCTION SERVER... NO ??? jeudi 18 octobre 12
23. What DEPLOYMENT means ? IT HAS TO BE as FAST as possible RELIABLE STABLE IT MUST provide ROLLBACK FEATURES var/ FOLDERS take of your deal with MULTIPLE ENVIRONMENTS OBVIOUSLY, YOU ONLY HAVE ONE PRODUCTION SERVER... NO ??? be able to manage MORE THAN 1 SERVER jeudi 18 octobre 12
24. DEPLOYMENT PROCESS - example jeudi 18 octobre 12
25. DEPLOYMENT PROCESS - example Pre-deployment operations jeudi 18 octobre 12
26. DEPLOYMENT PROCESS - example Pre-deployment operations REPLACE THIS WITH YOUR OWN PROCESSES USERS TESTS CONTINUOUS INTEGRATION jeudi 18 octobre 12
27. DEPLOYMENT PROCESS - example Source code operations Pre-deployment operations REPLACE THIS WITH YOUR OWN PROCESSES USERS TESTS CONTINUOUS INTEGRATION jeudi 18 octobre 12
28. DEPLOYMENT PROCESS - example Source code operations TAG GIT PUSH on a ref. repository anything... Pre-deployment operations REPLACE THIS WITH YOUR OWN PROCESSES USERS TESTS CONTINUOUS INTEGRATION jeudi 18 octobre 12
29. DEPLOYMENT PROCESS - example Source code operations TAG GIT PUSH on a ref. repository anything... Pre-deployment operations REPLACE THIS WITH YOUR OWN PROCESSES USERS TESTS CONTINUOUS INTEGRATION Production servers operations jeudi 18 octobre 12
30. DEPLOYMENT PROCESS - example Source code operations TAG GIT PUSH on a ref. repository anything... Pre-deployment operations REPLACE THIS WITH YOUR OWN PROCESSES USERS TESTS CONTINUOUS INTEGRATION Production servers operations UPDATE SOURCE CODE WARM UP CACHE GO LIVE with the new version jeudi 18 octobre 12
31. CAPISTRANO concepts & key features https://github.com/capistrano/capistrano jeudi 18 octobre 12
32. CAPISTRAwhat ? jeudi 18 octobre 12
33. CAPISTRAwhat ? CAPISTRANO jeudi 18 octobre 12
34. CAPISTRAwhat ? CAPISTRANO IS JUST A BUNCH OF SCRIPTS IS WRITTEN IN RUBY FOR RAILS HAS MULTIPLE DEPLOYMENT STRATEGY jeudi 18 octobre 12
35. CAPISTRAwhat ? WORKS WITH GIT SVN ... CAPISTRANO IS JUST A BUNCH OF SCRIPTS IS WRITTEN IN RUBY FOR RAILS HAS MULTIPLE DEPLOYMENT STRATEGY jeudi 18 octobre 12
36. CAPISTRAwhat ? WORKS WITH GIT SVN ... COMMAND LINE BASED CAPISTRANO IS JUST A BUNCH OF SCRIPTS IS WRITTEN IN RUBY FOR RAILS HAS MULTIPLE DEPLOYMENT STRATEGY jeudi 18 octobre 12
37. CAPISTRAwhat ? WORKS WITH GIT SVN ... COMMAND LINE BASED CAPISTRANO IS JUST A BUNCH OF SCRIPTS IS WRITTEN IN RUBY FOR RAILS HAS MULTIPLE DEPLOYMENT STRATEGY VERY BASIC REQUIREMENTS jeudi 18 octobre 12
38. CAPISTRAwhat ? WORKS WITH GIT SVN ... COMMAND LINE BASED CAPISTRANO IS JUST A BUNCH OF SCRIPTS IS WRITTEN IN RUBY FOR RAILS HAS MULTIPLE DEPLOYMENT STRATEGY VERY BASIC REQUIREMENTS LOCAL MACHINE RUBY jeudi 18 octobre 12
39. CAPISTRAwhat ? WORKS WITH GIT SVN ... COMMAND LINE BASED CAPISTRANO IS JUST A BUNCH OF SCRIPTS IS WRITTEN IN RUBY FOR RAILS HAS MULTIPLE DEPLOYMENT STRATEGY VERY BASIC REQUIREMENTS LOCAL MACHINE RUBY REMOTE SERVERS SSH SERVER NO RUBY REQUIRED UNIX-LIKE OS jeudi 18 octobre 12
40. jeudi 18 octobre 12
41. BASED ON TASKS setup check deploy:default deploy:update deploy:update_code deploy:finalize_code deploy:symlink deploy:restart jeudi 18 octobre 12
42. BEFORE & AFTER TRIGGERS BASED ON TASKS setup check deploy:default deploy:update deploy:update_code deploy:finalize_code deploy:symlink deploy:restart jeudi 18 octobre 12
43. BEFORE & AFTER TRIGGERS BUILDS & SENDS REQUESTS OVER SSH BASED ON TASKS setup check deploy:default deploy:update deploy:update_code deploy:finalize_code deploy:symlink deploy:restart jeudi 18 octobre 12
44. BEFORE & AFTER TRIGGERS BUILDS & SENDS REQUESTS OVER SSH MAKES USE OF SYMLINKS BASED ON TASKS setup check deploy:default deploy:update deploy:update_code deploy:finalize_code deploy:symlink deploy:restart jeudi 18 octobre 12
45. BEFORE & AFTER TRIGGERS BUILDS & SENDS REQUESTS OVER SSH MAKES USE OF SYMLINKS BASED ON TASKS setup check deploy:default deploy:update deploy:update_code deploy:finalize_code deploy:symlink deploy:restart ROLLBACK jeudi 18 octobre 12
46. BASIC SETUP jeudi 18 octobre 12
47. BASIC SETUP Requirements jeudi 18 octobre 12
48. BASIC SETUP RubyGems >= 1.3.x if needed => $ apt-get install rubygems Requirements $ gem instal capistrano jeudi 18 octobre 12
49. BASIC SETUP $ capify . [add] making directory './config' [add] writing './config/deploy.rb' [add] writing './Capfile' [done] capified! Capify your app locally RubyGems >= 1.3.x if needed => $ apt-get install rubygems Requirements $ gem instal capistrano jeudi 18 octobre 12
50. set :application, "myapp" set :repository, "username@github.com:myapp.git" set :deploy_to, "/var/www/#{application}" set :user, "deploymentuser" set :branch, "devel" # Or : accurev, bzr, cvs, darcs, git, mercurial, perforce, subversion or none set :scm, :git role :web, "www.myapp.com" # Your HTTP server, Apache/etc role :web, "78.123.21.5" # Another front server role :db, "www.myapp.com",:primary => true # Your main MySQL server role :db, "78.123.21.5" # A slave SQL server config/deploy.rb jeudi 18 octobre 12
51. DEAL WITH MULTISTAGE jeudi 18 octobre 12
52. $ gem install capistrano-ext DEAL WITH MULTISTAGE jeudi 18 octobre 12
53. config/deploy.rb $ gem install capistrano-ext DEAL WITH MULTISTAGE jeudi 18 octobre 12
54. require 'capistrano/ext/multistage' set :stages, %w(local devel preproduction production) set :default_stage, "devel" config/deploy.rb $ gem install capistrano-ext DEAL WITH MULTISTAGE jeudi 18 octobre 12
55. require 'capistrano/ext/multistage' set :stages, %w(local devel preproduction production) set :default_stage, "devel" config/deploy.rb config/deploy/devel.rb $ gem install capistrano-ext DEAL WITH MULTISTAGE jeudi 18 octobre 12
56. require 'capistrano/ext/multistage' set :stages, %w(local devel preproduction production) set :default_stage, "devel" config/deploy.rb role :web, ‘dev.myapp.com’ config/deploy/devel.rb $ gem install capistrano-ext DEAL WITH MULTISTAGE jeudi 18 octobre 12
57. require 'capistrano/ext/multistage' set :stages, %w(local devel preproduction production) set :default_stage, "devel" config/deploy.rb role :web, ‘dev.myapp.com’ config/deploy/devel.rb config/deploy/qa.rb $ gem install capistrano-ext DEAL WITH MULTISTAGE jeudi 18 octobre 12
58. require 'capistrano/ext/multistage' set :stages, %w(local devel preproduction production) set :default_stage, "devel" config/deploy.rb role :web, ‘dev.myapp.com’ config/deploy/devel.rb config/deploy/preproduction.rb config/deploy/qa.rb $ gem install capistrano-ext DEAL WITH MULTISTAGE jeudi 18 octobre 12
59. require 'capistrano/ext/multistage' set :stages, %w(local devel preproduction production) set :default_stage, "devel" config/deploy.rb role :web, ‘dev.myapp.com’ config/deploy/devel.rb config/deploy/preproduction.rb config/deploy/production.rb config/deploy/qa.rb $ gem install capistrano-ext DEAL WITH MULTISTAGE jeudi 18 octobre 12
60. require 'capistrano/ext/multistage' set :stages, %w(local devel preproduction production) set :default_stage, "devel" config/deploy.rb role :web, ‘dev.myapp.com’ config/deploy/devel.rb config/deploy/preproduction.rb config/deploy/production.rb config/deploy/qa.rb ..... $ gem install capistrano-ext DEAL WITH MULTISTAGE jeudi 18 octobre 12
61. jeudi 18 octobre 12
62. ON Enable jeudi 18 octobre 12
63. ON Enable Cap Capistrano jeudi 18 octobre 12
64. ON Enable AlCap Capistrano For eZ Publish http://alafon.github.com/alcapon/ jeudi 18 octobre 12
65. eZ Publish — Capistrano jeudi 18 octobre 12
66. eZ Publish — Capistrano Capezit jeudi 18 octobre 12
67. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit jeudi 18 octobre 12
68. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ jeudi 18 octobre 12
69. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL jeudi 18 octobre 12
70. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) jeudi 18 octobre 12
71. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) DATABASE IMPORT EXPORT jeudi 18 octobre 12
72. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) DATABASE IMPORT EXPORT VAR SYNC jeudi 18 octobre 12
73. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) DATABASE IMPORT EXPORT VAR SYNC AUTOLOADS & CACHE jeudi 18 octobre 12
74. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) DATABASE IMPORT EXPORT VAR SYNC AUTOLOADS & CACHE MANAGEMENT jeudi 18 octobre 12
75. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) DATABASE IMPORT EXPORT VAR SYNC AUTOLOADS & CACHE MANAGEMENT jeudi 18 octobre 12
76. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) DATABASE IMPORT EXPORT VAR SYNC AUTOLOADS & CACHE MANAGEMENT jeudi 18 octobre 12
77. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) DATABASE IMPORT EXPORT VAR SYNC AUTOLOADS & CACHE MANAGEMENT jeudi 18 octobre 12
78. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) DATABASE IMPORT EXPORT VAR SYNC AUTOLOADS & CACHE MANAGEMENT jeudi 18 octobre 12
79. eZ Publish — Capistrano $ gem install alcapon $ capezit . [add] writing './extension/alcapon/config/ezpublish.rb' [add] writing './extension/alcapon/config/deploy.rb' [add] writing './extension/alcapon/config/deploy/production.rb' [add] writing './extension/alcapon/config/deploy/devel.rb' [add] writing './Capfile' [done] Your eZ Publish project is now controlled by AlCapON ! Capezit Dedicated tasks to eZ LOCAL REMOTE SERVER(S) DATABASE IMPORT EXPORT VAR SYNC AUTOLOADS & CACHE MANAGEMENT jeudi 18 octobre 12
80. OTHER COOL FEATURES jeudi 18 octobre 12
81. OTHER COOL FEATURES system check (ezpublish.rb) jeudi 18 octobre 12
82. OTHER COOL FEATURES depend :remote, :command, "php" depend :remote, :match, "php -r \"echo(version_compare(PHP_VERSION,'5.2.14')?'ok':'ko');\"", "ok" depend :remote, :match, "php -m | grep curl", "curl" system check (ezpublish.rb) jeudi 18 octobre 12
83. OTHER COOL FEATURES depend :remote, :command, "php" depend :remote, :match, "php -r \"echo(version_compare(PHP_VERSION,'5.2.14')?'ok':'ko');\"", "ok" depend :remote, :match, "php -m | grep curl", "curl" system check (ezpublish.rb) check if you have local changes jeudi 18 octobre 12
84. OTHER COOL FEATURES depend :remote, :command, "php" depend :remote, :match, "php -r \"echo(version_compare(PHP_VERSION,'5.2.14')?'ok':'ko');\"", "ok" depend :remote, :match, "php -m | grep curl", "curl" system check (ezpublish.rb) check if you have local changes $ cap capez:dev:local_check /Users/alafon/Sites/alcapon-demo/local-install triggering load callbacks * 10:23:51 == Currently executing `devel' triggering start callbacks for `capez:dev:local_check' * 10:23:51 == Currently executing `multistage:ensure' * 10:23:51 == Currently executing `capez:dev:local_check' Checking your local git... You have new files Abort ? y/n (n) n You have 1 commits that need to be pushed Push them before deployment ? y/n (y) n jeudi 18 octobre 12
85. Cmnd_Alias DEPLOY_SHELLS = /bin/mkdir, /bin/chmod, /bin/chown, / bin/chgrp, /bin/ln, /usr/bin/php user ALL=(user) NOPASSWD: DEPLOY_SHELLS user ALL=(apache) NOPASSWD: DEPLOY_SHELLS give specific sudo rights to your deployment user use publickey on the remote server $ ssh-copy-id ~/.ssh/publickkey.pub user@domain.com A few tips jeudi 18 octobre 12
86. Not CLUSTER aware SCM tagging operations during deployment Only MySQL supported for backup Permissions issues Enable debug on remotes Not implemented yet ... .... Automated database backup during deployment with ROLLBACK SUPPORT jeudi 18 octobre 12
87. Demo jeudi 18 octobre 12