Capistrano для деплоймента PHP приложений Capistrano is a tool for deploying PHP applications. It allows deployments to be done with a single command. Capistrano handles tasks like updating files and databases, creating files/folders/symlinks, file permissions, cache clearing, and rolling back if errors occur. Common methods for deployment include FTP clients, version control hooks, Phing, shell scripts, and Rsync. Capistrano uses SSH and works with version control systems like Git, SVN, and Mercurial. It manages releases by creating dated directories and symlinking the current release. Custom tasks can be added to handle additional deployment steps.

1. Capistrano для
деплоймента PHP
приложений
Рома Лапин, Evercode Lab
@memphys, roma@evercodelab.com

2. If you cannot do your
deployments with one
command then you are
DOING IT WRONG.
Chris Hartjes, “Infrastructure Debt”
(http://www.littlehart.net/atthekeyboard/2011/11/03/infrastructure-debt/)

3. Обновить файлы
Обновить базу
Создать файлы, папки, симлинки
Выставить права
Сбросить кэш
Сохранить контент
Откатиться в случае ошибки

5. FTP-клиенты
VCS, hooks
Phing
Shell script
Rsync
WePloy

7. SSH
Git/SVN/Mercurial/...
Server

8. © http://capifony.org/

9. ├── current -> /var/www/zf-capistrano/releases/20120414205035
├── releases
│ ├── 20120414204853
│ │ ├── application
│ │ ├── ...
│ └── 20120414205035
│ ├── application
│ ├── ...
└── shared
├── cached-copy
│ ├── application
│ ├── ...
└── public
└── uploads

10. $ gem install capistrano

11. $ cd ~/Sites/mycoolproject
$ capify .
[add] writing './Capfile'
[add] making directory './config'
[add] writing './config/deploy.rb'
[done] capified!

12. config/deploy.rb
set :application, "application_name"
set :deploy_to, "/var/www/#{application}"

13. config/deploy.rb
set :scm, :git
set :repository, "git@github.com:user/app.git"
set :deploy_via, :remote_cache
set :branch, "master"
set :keep_releases, 3

14. config/deploy.rb
server "domain", :app, :web, :db, :primary => true
set :ssh_options, {:forward_agent => true, :port => 22}
set :user, "deployer"
set :use_sudo, false

15. $ cap -h
$ cap -T

16. config/deploy.rb
namespace :deploy do
task :start do
end
task :stop do
end
task :migrate do
end
task :restart do
end
end

17. $ gem install railsless-deploy
Capfile
require 'railsless-deploy'
load 'config/deploy'

18. $ cap deploy:setup
$ cap deploy:check

19. $ cap deploy

21. $ cap deploy:update
$ cap deploy:cleanup

23. $ cap deploy:rollback

25. Capfile (ZF1)
load 'config/deploy'

26. Capfile (ZF1)
load 'config/deploy'

27. Capfile (ZF1)
load 'config/deploy'
load 'application/configs/deploy'

28. application/configs/deploy.rb
namespace :myproject do
task :symlink, :roles => :app do
...
end
end
after "deploy:symlink", "myproject:symlink"

29. application/configs/deploy.rb
namespace :myproject do
task :symlink, :roles => :app do
...
end
end
after "deploy:symlink", "myproject:symlink"
run "mkdir -p #{shared_path}/library"
run "chmod -R 755 #{shared_path}/library"
run "ln -nfs /path/to/zf/library/Zend #{shared_path}/library/Zend"
run "ln -nfs #{shared_path}/library #{release_path}/library"

30. config/deploy.rb (ZF2)
namespace :myproject do
task :symlink, :roles => :app do
...
end
end
after "deploy:symlink", "myproject:symlink"

31. config/deploy.rb (ZF2)
namespace :myproject do
task :symlink, :roles => :app do
...
end
end
after "deploy:symlink", "myproject:symlink"
run "mkdir -p #{shared_path}/vendor/ZendFramework/library"
run "chmod -R 755 #{shared_path}/vendor/ZendFramework/library"
run "ln -nfs /path/to/ZendFramework-2.0.0beta3/library/Zend #{shared_path}/vendor/
ZendFramework/library/Zend"
run "rm -rf #{release_path}/vendor"
run "ln -nfs #{shared_path}/vendor #{release_path}/vendor"

32. application/configs/deploy.rb
namespace :myproject do
task :uploads, :roles => :app do
...
end
end
after "deploy:symlink", "myproject:symlink", "myproject:uploads"

33. application/configs/deploy.rb
namespace :myproject do
task :uploads, :roles => :app do
...
end
end
after "deploy:symlink", "myproject:symlink", "myproject:uploads"
run "mkdir -p #{shared_path}/public/uploads"
run "chmod -R 775 #{shared_path}/public/uploads"
run "ln -nfs #{shared_path}/public/uploads #{release_path}/public/uploads"

34. application/configs/deploy.rb
task :disable do
...
end
after "deploy:update_code", "myproject:disable"

35. application/configs/deploy.rb
task :disable do
...
end
after "deploy:update_code", "myproject:disable"
run "echo 'Site is on maintenance right now. Sorry.' > #{shared_path}/public/
maintenance.html"
run "cp #{shared_path}/public/maintenance.html #{latest_release}/public/
maintenance.html"

36. application/configs/deploy.rb
task :enable do
...
end
after "deploy:symlink", "myproject:enable"

37. application/configs/deploy.rb
task :enable do
...
end
after "deploy:symlink", "myproject:enable"
run "rm -f #{latest_release}/public/maintenance.html"

38. application/configs/deploy.rb
task :migrate do
...
end
after "deploy:finalize_update", "myproject:migrate"

39. application/configs/deploy.rb
task :migrate do
...
end
after "deploy:finalize_update", "myproject:migrate"
on_rollback { run "#{release_path}/bin/doctrine migrations:migrate down" }
run "#{release_path}/bin/doctrine migrations:migrate"

40. application/configs/deploy.rb
task :unicornsandwizards do
# notify by email
# post to irc or group chat
# send SMS
# activate SkyNet
# order some Pizza
end
after "deploy:finalize_update", "myproject:unicornsandwizards"

41. zf-capistrano
https://github.com/memphys/zf-capistrano
zf2-capistrano
https://github.com/memphys/zf2-capistrano
Capistrano home
https://github.com/capistrano/capistrano/wiki

42. Multistage
Capifony (http://capifony.org)
Webistrano

44. Спасибо за внимание
Рома Лапин
Evercode Lab
roma@evercodelab.com
@memphys