1. Deployment kodu
z Capistrano

2. Typowy proces
• Aktualizacja kodu
• Konfiguracja
• Instalacja zależności
• Aktualizacja bazy danych
• Uruchomienie aplikacji

3. Proste rozwiązanie
1. Pobierz najnowszą wersje kodu
2. Zaktualizuj wartości w plikach konfiguracyjnych
3. Zainstaluj zależne biblioteki A, B i C
4. Uruchom w bazie plik migrate.sql
5. Zrestartuj serwer

4. Problemy
• Plan awaryjny
• Aktualizacja wielu serwerów jednocześnie
• Współdzielenie plików pomiędzy releasami
• Zero downtime

5. Capistrano
• Narzędzie do zautomatyzowanego zarządzania
zdalnymi serwerami
• Pozwala w przyjazny sposób definiować i
wykonywać zadania lub całe ciągi zadań na
zdalnych maszynach
• Ruby gem
• Nakładka na gem SSHKit

6. Instalacja
$ gem install capistrano
$ cap install
!

7. Instalacja
"## Capfile
"## config
$ "## deploy
$ $ "## production.rb
$ $ %## staging.rb
$ %## deploy.rb
%## lib
%## capistrano
%## tasks

8. Capfile
# 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
#
# require 'capistrano/rails'
# require 'capistrano/laravel'
# require 'capistrano/symfony'
# require 'capistrano/npm'
!
# Loads custom tasks from `lib/capistrano/tasks' if you have any
defined.
Dir.glob('lib/capistrano/tasks/*.rake').each { |r| import r }

9. deploy.rb
set :application, "my_app"
set :scm, "git"
set :repo_url,
"git@github.com/me/my_app.git"
!
set :branch, "master"
set :deploy_to,
"/var/www/my_app"

10. deploy.rb
set :application, "my_app"
set :scm, "git"
set :repo_url,
"git@github.com/me/my_app.git"
!
set :branch, "master"
set :deploy_to,
"/var/www/#{fetch(:application)}"

11. production.rb
role :app, %w{user@s1.com user@s2.com}
role :web, %w{user@s1.com}
role :db, %w{user@s1.com}

12. Zadania
$ cap -T
cap deploy
cap deploy:check
cap deploy:rollback
!
$ cap production deploy
$ cap production deploy:check

13. Setup serwera
$ mkdir -p /var/www/my_app
$ chown -R deploy /var/www/my_app

14. Setup serwera
/var/www/my_app
"## releases
%## shared
"## bin
"## config
"## log
"## public
"## tmp
%## vendor

15. Deployment
/var/www/my_app
"## current (-> releases/20140521130616)
"## releases
$ %## 20140521130616
"## repo
"## releases.log
%## shared

16. revisions.log
$ cat revisions.log
Branch master (at 3fa7748) deployed as
release 20140521130616 by michal

17. Przydatne opcje
set :linked_files,
%w{config/database.yml}
!
set :linked_dirs,
%w{bin log tmp vendor public/system}
!
set :keep_releases, 5
!
ask :branch, "master"

18. Zadania
namespace :deploy do
task :my_task do
# treść
end
end

19. check_uptime
on release_roles(:all) do |host|
info "Running my task on #{host}"
execute :uptime
end

20. Flow
# check everything, start a deployment
deploy:starting
!
# update server(s) with a new release
deploy:updating
!
# publish the new release
deploy:publishing
!
# finish the deployment, clean up everything
deploy:finishing

21. Flow
deploy:starting
deploy:started
deploy:updating
deploy:updated
deploy:publishing
deploy:published
deploy:finishing
deploy:finished
!
before :starting, :my_task
after :finishing, :my_other_task

22. Rollback
deploy:starting
deploy:started
deploy:reverting
deploy:reverted
deploy:publishing
deploy:published
deploy:finishing_rollback
deploy:finished

23. Ruby on Rails Flow
deploy
deploy:starting
deploy:started
deploy:updating
deploy:updated
deploy:publishing
deploy:published
deploy:finishing
deploy:finished

24. Ruby on Rails Flow
deploy
deploy:starting
[before]
deploy:ensure_stage
deploy:set_shared_assets
deploy:check
deploy:started
deploy:updating
deploy:updated
deploy:publishing
deploy:published
deploy:finishing
deploy:finished

25. Ruby on Rails Flow
deploy
deploy:starting
deploy:started
deploy:updating
git:create_release
deploy:symlink:shared
deploy:updated
deploy:publishing
deploy:published
deploy:finishing
deploy:finished

26. Ruby on Rails Flow
deploy
deploy:starting
deploy:started
deploy:updating
deploy:updated
[before]
deploy:bundle
[after]
deploy:migrate
deploy:compile_assets
deploy:normalize_assets
deploy:publishing
deploy:published
deploy:finishing
deploy:finished

27. Ruby on Rails Flow
deploy
deploy:starting
deploy:started
deploy:updating
deploy:updated
deploy:publishing
deploy:symlink:release
deploy:restart
deploy:published
deploy:finishing
deploy:finished

28. Ruby on Rails Flow
deploy
deploy:starting
deploy:started
deploy:updating
deploy:updated
deploy:publishing
deploy:published
deploy:finishing
deploy:cleanup
deploy:finished

29. Ruby on Rails Flow
deploy
deploy:starting
deploy:started
deploy:updating
deploy:updated
deploy:publishing
deploy:published
deploy:finishing
deploy:finished
deploy:log_revision

30. Best practices
• Trzymać konfigurację deploymentu w repozytorium
• Nie trzymać wrażliwych danych w repozytorium, tylko w shared
na serwerze
• Kompilować kod na serwerze zamiast trzymać skompilowany kod
w repozytorium
• Dla customowych zadań napisać hooki do deploy:starting i
deploy:reverting
• Rozbudować deploy:check o sprawdzanie zależnych bibliotek
• Nie próbować zautomatyzować absolutnie wszystkiego

31. Pytania?
Michał Szajbe
!
monterail.com
!
@szajbus