The document discusses automating software deployment using Ansible. It provides an overview of Ansible's basic concepts like inventory files to define hosts, playbooks to execute tasks on hosts, and roles to bundle related tasks. It then discusses using Ansible roles to automate deployments, including the ansistrano roles which can deploy applications by copying files, managing releases, and supporting deployment hooks. Overall the document presents Ansible as a way to easily automate and standardize software deployment processes.

1. By Pablo Godel
@pgodel
Deploying
Photo by @old_sound
Symfony
Catalunya
2016

2. Deployment

3. ?
Deployment

4. Deployment
Software deployment is all of the activities that
make a software system available for use.
http://en.wikipedia.org/wiki/Software_deployment

5. A very important critical part
of the application life-cycle
Deployment

6. It should not be an
after thought
Deployment

7. It should be
predictable
Deployment

8. It is also…
Deployment

9. It is also BORING
Deployment

17. Why is it BORING?
Deployment

18. It’s repetitive
Deployment

19. It’s repetitive
Deployment
• Copy files to server(s)

20. It’s repetitive
Deployment
• Copy files to server(s)
• Setup parameters

21. It’s repetitive
Deployment
• Copy files to server(s)
• Setup parameters
• Build assets

22. It’s repetitive
Deployment
• Copy files to server(s)
• Setup parameters
• Build assets
• Run migrations

23. It’s repetitive
Deployment
• Copy files to server(s)
• Setup parameters
• Build assets
• Run migrations
• Restart web server(s)

24. It’s repetitive
Deployment
• Copy files to server(s)
• Setup parameters
• Build assets
• Run migrations
• Restart web server(s)
REPEAT INDEFINITELY

25. Developers != Musicians

26. It’s repetitive
Deployment
• Copy files to server(s)
• Setup parameters
• Build assets
• Run migrations
• Restart web server(s)LET’S AUTOMATE

31. Automation Benefits
Deployment

32. Automation Benefits
• Easy launch
Deployment

33. Automation Benefits
• Easy launch
• Consistent results
Deployment

34. Automation Benefits
• Easy launch
• Consistent results
• Rollbacks
Deployment

35. Automation Benefits
• Easy launch
• Consistent results
• Rollbacks
• Scalable & secure
Deployment

36. Automation Benefits
• Easy launch
• Consistent results
• Rollbacks
• Scalable & secure
• Documented procedure
Deployment

37. Automation Benefits
• Easy launch
• Consistent results
• Rollbacks
• Scalable & secure
• Documented procedure
• No human intervention
Deployment

38. Automation Benefits
• Easy launch
• Consistent results
• Rollbacks
• Scalable & secure
• Documented procedure
• No human intervention
Deployment

39. Automation Benefits
• No human intervention
Deployment

40. Automation Benefits
• No human intervention

41. Automation Benefits
• No human intervention
Deployment

42. Automation Benefits
• No human intervention
Deployment

43. Automation Benefits
• No human intervention
Deployment
$ sudo rm -rf / var/log/*

44. Simplest Automation
Deployment
git push origin master github.com

45. Simplest Automation
Deployment
git push origin master
www.example.com/
hook.php
github.com

46. Simplest Automation
Deployment
git push origin master
www.example.com/
hook.php
git pull
github.com

47. <?php
exec(‘/usr/bin/env -i HOME=/var/www git pull’);
echo “All done!”;
hook.php
GitHub hook
Deployment
Simplest Automation

48. <?php
exec(‘/usr/bin/env -i HOME=/var/www git pull’);
exec(‘/usr/bin/env -i HOME=/var/www composer install’);
exec(‘/usr/bin/env -i HOME=/var/www app/console ca:cl’);
echo “All done!”;
hook.php
Deployment
Simplest Automation

49. Deployment: Copying files
Avoid insecure &
inconsistent methods
• FTP
• SCP
• rsync
• git pull

50. Deployment: Copying files
Create consistency
|-- releases

51. Deployment: Copying files
Create consistency
|-- releases
| `-- 20160712

52. Deployment: Copying files
Create consistency
|-- releases
| `-- 20160712
| `-- 20160715

53. Deployment: Copying files
Create consistency
|-- releases
| `-- 20160712
| `-- 20160715
`——current -> 20160715

54. Deployment: Copying files
Create consistency
|-- releases
| `-- 20160712
| `-- 20160715
| `—current -> 20160715
`-- shared
|-- logs
`-- uploads

55. Deployment: Copying files
Create consistency
|-- releases
| `-- 20160712
| `-- 20160715
| `—current -> 20160712
`-- shared
|-- logs
`-- uploads

56. Deploying

57. Deploying
Not rocket science!

58. Deploying
http://symfony.com/doc/current/cookbook/deployment/tools.html

59. Deploying
1) Upload/Install Code

60. Deploying
1) Upload/Install Code
2) Install dependencies

61. Deploying
1) Upload/Install Code
2) Install dependencies
3) Run DB migrations

62. Deploying
1) Upload/Install Code
2) Install dependencies
3) Run DB migrations
4) Install/Build assets

63. Deploying
1) Upload/Install Code
2) Install dependencies
3) Run DB migrations
4) Install/Build assets
5) Clear/Warm cache

64. Deploying
1) Upload/Install Code
2) Install dependencies
3) Run DB migrations
4) Install/Build assets
5) Clear/Warm cache
6) Reload Server/Queues/Other

65. Deploying
$ git clone / git pull / git checkout -b branch tag

66. Deploying
$ git clone / git pull / git checkout -b branch tag
$ composer.phar install

67. Deploying
$ git clone / git pull / git checkout -b branch tag
$ composer.phar install
$ app/console doctrine:migration:migrate --no-iteration

68. Deploying
$ git clone / git pull / git checkout -b branch tag
$ composer.phar install
$ app/console doctrine:migration:migrate --no-iteration
$ app/console assets:install web --symlink

69. Deploying
$ git clone / git pull / git checkout -b branch tag
$ composer.phar install
$ app/console doctrine:migration:migrate --no-iteration
$ app/console assets:install web --symlink
$ app/console assetic:dump --env=prod

70. Deploying
$ git clone / git pull / git checkout -b branch tag
$ composer.phar install
$ app/console doctrine:migration:migrate --no-iteration
$ app/console assets:install web --symlink
$ app/console assetic:dump --env=prod
$ app/console cache:clear --env=prod —no-debug

71. Deployment
Automating the process

72. Deployment: Automating

73. Deployment: Automating
http://deployer.org/

74. Deployment: Automating
http://deployer.org/
Magallanes

75. Deployment: Automating
Fabric
http://deployer.org/
Magallanes

76. Deployment: Automating
Fabric
http://deployer.org/
Magallanes

77. Deployment: Automating
Fabric
http://deployer.org/
Magallanes

78. Deployment: Automating
Fabric
http://deployer.org/
Magallanes

79. Deployment: Automating

80. Deployment: Automating
• Friendly, simple to configure & maintain

81. Deployment: Automating
• Friendly, simple to configure & maintain
• Flexible and extensible

82. Deployment: Automating
• Friendly, simple to configure & maintain
• Flexible and extensible
• Agentless

83. Deployment: Automating
• Friendly, simple to configure & maintain
• Flexible and extensible
• Agentless
• Integration with Cloud and Containers

84. Deploy apps. Manage systems. Crush complexity.
Ansible helps you build a strong foundation for DevOps.
AUTOMATION FOR EVERYONE

85. The Basics: inventory
Define hosts in inventory file
[webservers]
foo.example.com
bar.example.com
www[01:50].example.com
[dbservers]
one.example.com
two.example.com
three.example.com

86. hosts/dev
[webservers]
www.dev.example.com
[dbservers]
db1.dev.example.com
hosts/prod
[webservers]
prod-[1-5].example.com
[dbservers]
db1.example.com
The Basics: inventory

87. hosts/dev
$ ansible -i hosts/dev webservers -a “uptime”
hosts/prod
$ ansible -i hosts/prod all -a “uptime”
The Basics: inventory

88. setup.yml
---
- hosts: webservers
vars:
http_port: 80
max_clients: 200
remote_user: root
tasks:
- name: ensure apache is at the latest version
yum: pkg=httpd state=latest
- name: write the apache config file
template: src=/srv/httpd.j2 dest=/etc/httpd.conf
notify:
- restart apache
- name: ensure apache is running
service: name=httpd state=started
handlers:
- name: restart apache
service: name=httpd state=restarted
The Basics: playbooks

89. ---
- hosts: webservers
vars:
http_port: 80
max_clients: 200
remote_user: root
tasks:
- name: ensure apache is at the latest version
yum: pkg=httpd state=latest
- name: write the apache config file
template: src=/srv/httpd.j2 dest=/etc/httpd.conf
notify:
- restart apache
- name: ensure apache is running
service: name=httpd state=started
handlers:
- name: restart apache
service: name=httpd state=restarted
setup.yml
The Basics: playbooks

90. ---
- hosts: webservers
vars:
http_port: 80
max_clients: 200
remote_user: root
tasks:
- name: ensure apache is at the latest version
yum: pkg=httpd state=latest
- name: write the apache config file
template: src=/srv/httpd.j2 dest=/etc/httpd.conf
notify:
- restart apache
- name: ensure apache is running
service: name=httpd state=started
handlers:
- name: restart apache
service: name=httpd state=restarted
setup.yml
The Basics: playbooks

91. ---
- hosts: webservers
vars:
http_port: 80
max_clients: 200
remote_user: root
tasks:
- name: ensure apache is at the latest version
yum: pkg=httpd state=latest
- name: write the apache config file
template: src=/srv/httpd.j2 dest=/etc/httpd.conf
notify:
- restart apache
- name: ensure apache is running
service: name=httpd state=started
handlers:
- name: restart apache
service: name=httpd state=restarted
setup.yml
The Basics: playbooks

92. The Basics: playbooks
---
- hosts: webservers
vars:
http_port: 80
max_clients: 200
remote_user: root
tasks:
- name: ensure apache is at the latest version
yum: pkg=httpd state=latest
- name: write the apache config file
template: src=/srv/httpd.j2 dest=/etc/httpd.conf
notify:
- restart apache
- name: ensure apache is running
service: name=httpd state=started
handlers:
- name: restart apache
service: name=httpd state=restarted
setup.yml

93. The Basics: roles
Installing roles from Ansible Galaxy
$ ansible-galaxy install servergrove.symfony2
https://galaxy.ansible.com/

94. The Basics: roles
deploy.yml
- hosts: webservers
roles:
- {
role: servergrove.symfony2,
symfony2_project_root: /var/www/vhosts/
example.com/,
symfony2_project_name: demo,
symfony2_project_branch: master ,
symfony2_project_release: 1
}

95. The Basics: execution
Executing a playbook
$ ansible-playbook -i hosts/prod deploy.yml -v

96. The Basics: execution
Executing a playbook

97. The Basics: roles
Roles for deploying Symfony

98. The Basics: roles
• servergrove.symfony2

99. The Basics: roles
• servergrove.symfony2
• ansistrano

100. The Basics: roles
• servergrove.symfony2
• ansistrano
• cbrunnkvist.ansistrano-symfony-deploy

101. Ansistrano
ansistrano.deploy and ansistrano.rollback are Ansible
Galaxy roles to easily manage the deployment process for
scripting applications such as PHP, Python and Ruby.
http://ansistrano.com/

102. Ansistrano
ansistrano.deploy and ansistrano.rollback are Ansible
Galaxy roles to easily manage the deployment process for
scripting applications such as PHP, Python and Ruby.
http://ansistrano.com/

103. Ansistrano
ansistrano.deploy and ansistrano.rollback are Ansible
Galaxy roles to easily manage the deployment process for
scripting applications such as PHP, Python and Ruby.
http://ansistrano.com/

104. Ansistrano
ansistrano.deploy and ansistrano.rollback are Ansible
Galaxy roles to easily manage the deployment process for
scripting applications such as PHP, Python and Ruby.
http://ansistrano.com/

105. Ansistrano
ansistrano.deploy and ansistrano.rollback are Ansible
Galaxy roles to easily manage the deployment process for
scripting applications such as PHP, Python and Ruby.
$ ansible-galaxy install
carlosbuenosvinos.ansistrano-deploy
carlosbuenosvinos.ansistrano-rollback

106. Ansistrano: workflow

107. Ansistrano: variables

108. Ansistrano: variables

109. Ansistrano: variables

110. Ansistrano: variables

111. Ansistrano: deploy
---
- name: Deploy example app to my-server.com
hosts: all
vars:
ansistrano_deploy_from: "{{ playbook_dir }}/../my-app"
ansistrano_deploy_to: “/var/www/my-app.com”
ansistrano_keep_releases: 3
ansistrano_deploy_via: copy
roles:
- { role: carlosbuenosvinos.ansistrano-deploy }

112. Ansistrano: deploy
---
- name: Deploy example app to my-server.com
hosts: all
vars:
ansistrano_deploy_from: "{{ playbook_dir }}/../my-app"
ansistrano_deploy_to: “/var/www/my-app.com”
ansistrano_keep_releases: 3
ansistrano_deploy_via: copy
roles:
- { role: carlosbuenosvinos.ansistrano-deploy }

113. Ansistrano: deploy
---
- name: Deploy example app to my-server.com
hosts: all
vars:
ansistrano_deploy_from: "{{ playbook_dir }}/../my-app"
ansistrano_deploy_to: “/var/www/my-app.com”
ansistrano_keep_releases: 3
ansistrano_deploy_via: copy
roles:
- { role: carlosbuenosvinos.ansistrano-deploy }

114. Ansistrano: deploy
---
- name: Deploy example app to my-server.com
hosts: all
vars:
ansistrano_deploy_from: "{{ playbook_dir }}/../my-app"
ansistrano_deploy_to: “/var/www/my-app.com”
ansistrano_keep_releases: 3
ansistrano_deploy_via: copy
roles:
- { role: carlosbuenosvinos.ansistrano-deploy }

115. Ansistrano: deploy
$ ansible-playbook -i hosts deploy.yml

116. Ansistrano: deploy
$ ansible-playbook -i hosts deploy.yml
-- /var/www/my-app.com
|-- current -> /var/www/my-app.com/releases/20100509145325
|-- releases
| |-- 20100509145325
|-- shared

117. ---
- name: Rollback example app to my-server.com
hosts: all
vars:
ansistrano_deploy_to: “/var/www/my-app.com"
roles:
- { role: carlosbuenosvinos.ansistrano-rollback }
Ansistrano: rollback
rollback.yml

118. ---
- name: Rollback example app to my-server.com
hosts: all
vars:
ansistrano_deploy_to: “/var/www/my-app.com"
roles:
- { role: carlosbuenosvinos.ansistrano-rollback }
Ansistrano: rollback
rollback.yml

119. Ansistrano: rollback
$ ansible-playbook -i hosts rollback.yml

120. Ansistrano: hooks
---
- name: hook | Restart php-fpm
service: name=php5-fpm state=restarted
when: symfony_project_env == "prod"
my-after-symlink-tasks.yml
ansistrano_after_symlink_tasks_file: "{{ playbook_dir }}/
<your-deployment-config>/my-after-symlink-tasks.yml"
Adding a hook to deploy.ml to restart php-fpm

121. Ansistrano: hooks
---
- name: hook | Copy local.yml
copy: src=config/local.yml
dest={{ansistrano_release_path.stdout}}/config/local.yml
owner=web group=web mode=0644
my-before-symlink-shared-tasks.yml
ansistrano_before_symlink_shared_tasks_file: "{{ playbook_dir }}/
<your-deployment-config>/my-before-symlink-shared-tasks.yml"
Adding a hook to deploy.ml to copy local.yml

122. Ansistrano: hooks
---
- name: hook | Render local.yml
template: src=ansible/templates/local.yml.j2
dest={{ansistrano_release_path.stdout}}/config/local.yml
owner=web group=web mode=0644
my-before-symlink-shared-tasks.yml
ansistrano_before_symlink_shared_tasks_file: "{{ playbook_dir }}/
<your-deployment-config>/my-before-symlink-shared-tasks.yml"
Adding a hook to deploy.ml to copy local.yml

123. ansistrano-symfony-deploy
https://github.com/cbrunnkvist/ansistrano-symfony-deploy
Deploying

124. ansistrano-symfony-deploy
Deploying

125. ansistrano-symfony-deploy
symfony_env: prod
symfony_php_path: php # The PHP executable to use for all command line tasks
symfony_run_composer: true
symfony_composer_path: "{{ ansistrano_deploy_to }}/composer.phar"
symfony_composer_options: '--no-dev --optimize-autoloader --no-interaction'
symfony_composer_self_update: true # Always attempt a composer self-update
symfony_run_assets_install: true
symfony_assets_options: '--no-interaction'
symfony_run_assetic_dump: true
symfony_assetic_options: '--no-interaction'
symfony_run_cache_clear_and_warmup: true
Role variables

126. ansistrano-symfony-deploy
symfony_env: prod
symfony_php_path: php # The PHP executable to use for all command line tasks
symfony_run_composer: true
symfony_composer_path: "{{ ansistrano_deploy_to }}/composer.phar"
symfony_composer_options: '--no-dev --optimize-autoloader --no-interaction'
symfony_composer_self_update: true # Always attempt a composer self-update
symfony_run_assets_install: true
symfony_assets_options: '--no-interaction'
symfony_run_assetic_dump: true
symfony_assetic_options: '--no-interaction'
symfony_run_cache_clear_and_warmup: true
Role variables

127. ansistrano-symfony-deploy
symfony_env: prod
symfony_php_path: php # The PHP executable to use for all command line tasks
symfony_run_composer: true
symfony_composer_path: "{{ ansistrano_deploy_to }}/composer.phar"
symfony_composer_options: '--no-dev --optimize-autoloader --no-interaction'
symfony_composer_self_update: true # Always attempt a composer self-update
symfony_run_assets_install: true
symfony_assets_options: '--no-interaction'
symfony_run_assetic_dump: true
symfony_assetic_options: '--no-interaction'
symfony_run_cache_clear_and_warmup: true
Role variables

128. ansistrano-symfony-deploy
symfony_env: prod
symfony_php_path: php # The PHP executable to use for all command line tasks
symfony_run_composer: true
symfony_composer_path: "{{ ansistrano_deploy_to }}/composer.phar"
symfony_composer_options: '--no-dev --optimize-autoloader --no-interaction'
symfony_composer_self_update: true # Always attempt a composer self-update
symfony_run_assets_install: true
symfony_assets_options: '--no-interaction'
symfony_run_assetic_dump: true
symfony_assetic_options: '--no-interaction'
symfony_run_cache_clear_and_warmup: true
Role variables

129. ansistrano-symfony-deploy
symfony_env: prod
symfony_php_path: php # The PHP executable to use for all command line tasks
symfony_run_composer: true
symfony_composer_path: "{{ ansistrano_deploy_to }}/composer.phar"
symfony_composer_options: '--no-dev --optimize-autoloader --no-interaction'
symfony_composer_self_update: true # Always attempt a composer self-update
symfony_run_assets_install: true
symfony_assets_options: '--no-interaction'
symfony_run_assetic_dump: true
symfony_assetic_options: '--no-interaction'
symfony_run_cache_clear_and_warmup: true
Role variables

130. ansistrano-symfony-deploy
symfony_run_assets_install: true
symfony_assets_options: '--no-interaction'
symfony_run_assetic_dump: true
symfony_assetic_options: '--no-interaction'
symfony_run_cache_clear_and_warmup: true
symfony_cache_options: ''
##########################################################
symfony_run_doctrine_migrations: false
symfony_doctrine_options: '--no-interaction'
Role variables

131. ansistrano-symfony-deploy
---
- hosts: all
gather_facts: false
vars:
ansistrano_deploy_from: ../my-project-checkout
ansistrano_deploy_to: /home/app-user/my-project-deploy/
ansistrano_before_symlink_tasks_file: "{{playbook_dir}}/config/
app_specific_setup.yml"
roles:
- cbrunnkvist.ansistrano-symfony-deploy
deploy.yml

132. ansistrano-symfony-deploy
---
- hosts: all
gather_facts: false
vars:
ansistrano_deploy_from: ../my-project-checkout
ansistrano_deploy_to: /home/app-user/my-project-deploy/
ansistrano_before_symlink_tasks_file: "{{playbook_dir}}/config/
app_specific_setup.yml"
roles:
- cbrunnkvist.ansistrano-symfony-deploy
deploy.yml

133. ansistrano-symfony-deploy
---
- hosts: all
gather_facts: false
vars:
ansistrano_deploy_from: ../my-project-checkout
ansistrano_deploy_to: /home/app-user/my-project-deploy/
ansistrano_before_symlink_tasks_file: "{{playbook_dir}}/config/
app_specific_setup.yml"
roles:
- cbrunnkvist.ansistrano-symfony-deploy
deploy.yml

134. ansistrano-symfony-deploy
---
- hosts: all
gather_facts: false
vars:
ansistrano_deploy_from: ../my-project-checkout
ansistrano_deploy_to: /home/app-user/my-project-deploy/
ansistrano_before_symlink_tasks_file: "{{playbook_dir}}/config/
app_specific_setup.yml"
roles:
- cbrunnkvist.ansistrano-symfony-deploy
deploy.yml

135. ansistrano-symfony-deploy
$ ansible-playbook -i hosts deploy.yml

136. Extras: fpm
Packaging apps with fpm
Build packages for multiple platforms (deb, rpm, etc) with great ease and sanity.
https://github.com/jordansissel/fpm
$ fpm -s dir -t rpm -n "myapp" -v 1.0 /var/www/myapp
$ fpm -s dir -t deb -a all -n myapp -v 1.0 /etc/apache2/
conf.d/my.conf /var/www/myapp

137. ExtrasDeploying
Continuous Delivery
Workflow

138. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

139. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

140. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

141. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

142. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

143. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

144. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

145. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

146. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

147. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

148. Developer
Tests
build artifact
Ansible Production
GitHub
Jenkins QA deploy
Integration
Tests
Notifications
Extras: workflowDeploying

149. Thank you!
http://slideshare.net/pgodel
@pgodel
Deploying
Symfony
Catalunya
2016