This document introduces Ansible, an IT automation tool. It discusses what Ansible is, its key features and uses cases like server provisioning, deployment, and configuration management. It also provides information on installing and using Ansible, including requirements, modules, inventory, playbooks and roles. Finally, it discusses real world examples and resources for learning more about Ansible.

1. Igor Brovchenko
Let's Get Acquainted:

2. About me
• Engineer
• Chief Software Engineer at Swivl
• Symfony Camp UA
Igor Brovchenko
igor.Brovchenko@gmail.com
@tigordev

3. What is Ansible?
• Ansible is an IT automation tool (Python)
• Free, open source (github)
• Simply
• Clear (anyone)
• Fast (to learn, setup)
• Complete (modules)
• Efficient (runs on OpenSSH)
• Secure (without agents)

4. Use cases
• Server provisioning
• Server orchestration
• Application deployment
• Continues Integration
• …

5. Who uses Ansible?
Over 1 Million Downloads
Over 900 contributors
and 8000 ★s on GitHub

6. Other tools
• fabric
• capistrano (capifony)
• puppet
• chef
• saltstack

7. Ansible 1.7.2
• Development - 1.8
• A new major release of Ansible
approximately every 2 months.

8. Control Machine Requirements
• Red Hat
• Debian
• CentOS
• OS X
• any of the BSDs
• Windows isn’t supported for the control
machine
• Ansible 1.8:Windows will be fully supported
Python 2.6

9. Managed Node Requirements
• Python 2.4
• Starting in version 1.7, Ansible contains support
for managing Windows machines

10. https://galaxy.ansible.com/

12. http://www.ansible.com/tower

14. Symfony Deployment
1. Update the code
2. Update vendor dependencies
3. Running database migrations
4. Update Assetic Assets
5. Clearing the cache
6. Other Things…

15. Symfony Deployment
$ git pull
$ php composer.phar install
$ php app/console doctrine:migrations:migrate —no-interaction
$ php app/console assets:install web —symlink
$ php app/console assetic:dump --env=prod
$ php app/console cache:clear

16. Directory Structure
`-- /var/www/example.com
|-- current → /var/www/example.com/releases/20141012131539
|-- releases
| `-- 20141012131539
| `-- 20141009150741
| `-- 20141031145325
`-- shared
|-- web
| `-- uploads
|-- logs
`-- config
`-- parameters.yml

17. Installing the Control Machine
(Mac OSX)
$ brew update
$ brew install ansible
$ ansible-galaxy install servergrove.symfony2

18. Installing the Control Machine
(Mac OSX)
$ ls /usr/local/etc/ansible
hosts roles
$ ls /usr/local/etc/ansible/hosts/roles
servergrove.symfony2

19. Deploy
$ ansible-playbook app/config/playbook_deploy.yml
$ ansible-playbook -l localhost app/config/playbook_deploy.yml -vvv

20. playbook_deploy.yml
- hosts: stage-app
vars:
symfony2_project_name: Deploy the application
symfony2_project_root: /var/www/example.com
symfony2_project_release: '{{ current_timestamp.stdout }}'
symfony2_project_repo: git@github.com:ingvar/ExampleApp.git
symfony2_project_branch: release
symfony2_project_php_path: /usr/local/php55/bin/php
symfony2_project_env: prod
symfony2_project_console_opts: '--no-debug'
symfony2_project_composer_opts: '--no-dev --optimize-autoloader'
roles:
- servergrove.symfony2
tasks:
- local_action: osx_say msg="Deployment complete." voice=Zarvox

21. Inventory (hosts)
[localhost]
localhost ansible_connection=local
[stage-app]
stage.example.com ansible_connection=ssh
[prod-app]
www1.example.com
www2.example.com
www[10:50].example.com
[databases]
db-[a:f].example.com

22. Inventory (hosts)
$ ansible localhost -m command "echo "Hello World" "
$ ansible prod-app -m ping

23. Ansible Structure
• Inventory
• Modules
• Ad Hoc Commands
• Playbooks
• Tasks
• Variables
• Templates
• Handlers
• Roles

24. Modules
• Cloud
• Commands
• Database
• Files
• Internal
• Inventory
• Messaging
• Monitoring
• Net Infrastructure
• Network
• Notification
• Packaging
• Source Control
• System
• Utilities
• Web Infrastructure
• Windows

25. Modules
• Cloud (DO, AWS,Azure, GCE, Docker)
• DB (Mongo, MySQL, Postgres, Redis, Riak)
• Messaging (RabbitMQ)
• Monitoring (Zabbix, Monit, Nagios, New Relic…)
• Web (apache, supervisord…)
• Docker
• Vagrant
• …

26. Notification Modules
• flowdock
• hipchat
• irc
• jabber
• slac
• sns
• twilio
• …

27. Cron module
# Ensure a job that runs at 2 and 5 exists.
# Creates an entry like "* 5,2 * * ls -alh > /dev/null"
- cron: name="check dirs" hour="5,2" job="ls -alh > /dev/null"
# Ensure an old job is no longer present. Removes any job that is prefixed
# by "#Ansible: an old job" from the crontab
- cron: name="an old job" state=absent
# Creates an entry like "@reboot /some/job.sh"
- cron: name="a job for reboot" special_time=reboot job="/some/job.sh"
# Creates a cron file under /etc/cron.d
- cron: name="yum autoupdate" weekday="2" minute=0 hour=12
user="root" job="YUMINTERACTIVE=0 /usr/sbin/yum-autoupdate"
cron_file=ansible_yum-autoupdate
# Removes a cron file from under /etc/cron.d

28. http://docs.ansible.com/guide_vagrant.html

29. Roles
• YAML
• Documentation
• Modules (task)
• Ansible Galaxy

30. Tasks (main.yml)

31. Templates
• Templates are processed by the Jinja2 templating
language (http://jinja.pocoo.org/docs/dev/templates/)
• Powerful conditionals
• Loops and iterators

32. Example templates
• ApacheVirtualHost configuration file
• HAProxy configuration
• …

33. Rollback?
• http://www.servermanaged.it/ansible/ansible-simple-
rollback-strategy/
• http://www.future500.nl/articles/2014/07/thoughts-
on-deploying-with-ansible/

34. Resources
• http://docs.ansible.com/
• http://docs.ansible.com/
playbooks_best_practices.html
• https://galaxy.ansible.com/
• https://github.com/ansible/ansible-examples
• https://github.com/leucos/ansible-tuto

35. Books

37. Real world
app 1
app 2
app 3
DB - master
DB - slave
RabbitMQ
Redisapp 4
storage
transcoder
logs
monitoring

39. Questions?
• Igor Brovchenko
• @tigordev
• igor.Brovchenko@gmail.com
• http://ua.linkedin.com/in/IgorBrovchenko