Ansible Resources

User contributed playbooks, modules, and articles. This is a small curated list, but growing. Everyone is encouraged to add to this document, just edit it on Github and send a pull request!

Ansible Modules

Ansible modules are a way of adding new client-side logic to ansible. They can be written in any language. Generally our goal is to include most modules in core ("batteries included!"), though a few may remain outside of core depending on use cases and implementations.

Official "core" ansible modules - various
Linode - Lex Toumbourou
zypper (bash module example) - jp_mens
additional provisioning-related modules - jhoekx and dagwieers
dynamic dns updates - jp_mens
apk-tools - Bartłomiej Piotrowski

All python modules (especially all submitted to core) should use the common "AnsibleModule" class to dramatically reduce the amount of boilerplate code required.

Not all modules above may take advantage of this feature. See the official documentation for more details.

Selected Playbooks

Playbooks are Ansible's configuration management language. It should be easy to write your own from scratch for most applications (we keep the language simple for EXACTLY that reason), but it can be helpful to look at what others have done for reference and see what is possible.

The ansible-examples repo on github contains some examples of best-practices Ansible content deploying some full stack workloads:

Ansible-Examples

And here are some other community-developed playbooks. Feel free to submit a pull request to the docs to add your own.

edX Online - edX Online
Fedora Infrastructure - Fedora
Hadoop - jkleint
LAMP - Four Kitchens
LEMP - francisbesset
Ganglia (demo) - mpdehaan
Nginx - cocoy
OpenStack - lorin
Systems Configuration - cegeddin

Callbacks and Plugins

The Ansible project has a whole repo devoted to extending ansible with new connection types, logging/event callbacks, and inventory data storage. Talk to Cobbler and EC2, tweak the way things are logged, or even add sound effects.

Ansible-Plugins
Various modules, plugins, and scripts sergevanginderachter

Scripts And Misc

Ansible isn't just a program, it's also an API. Here's some examples of some clever integrations with the "Runner" and also Playbook APIs, and integrations with other interesting pieces of software.

Ansible Vagrant plugin - dsander
Ansible+Vagrant Tutorial - mattupstate -
virt-install - skvidal
rebooting hosts - skvidal
uptime (API demo) - mpdehaan
vim snippet generator - bleader

Blogs, Videos & Articles

HighScalability.com - mpdehaan
ColoAndCloud.com interview - mpdehaan
dzone - Mitch Pronschinske
Configuration Management With Ansible - jp_mens
Shell Scripts As Ansible Modules - jp_mens
Ansible Facts - jp_mens
Infrastructure as Data - cocoy
Ansible Pull Mode - cocoy
Exploring Configuration Management With Ansible - Palamino DB
You Should Consider Using SSH Based Configuration Management - LShift Ltd
Deploying Flask/uWSGI, Nginx, and Supervisorctl - mattupstate
Infracoders Presentation - Daniel Hall
Ansible - an introduction - jp_mens
Using Ansible to setup complex networking - - Robert Verspuy
Video presentation to Montreal Linux - Alexandre Bourget
Provisioning CentOS EC2 Instances with Ansible - jp_mens

Disclaimer

Modules and playbooks here may not be using the latest in Ansible features. When in doubt to the features of a particular version of Ansbile, always consult ansible.cc and in particular see Best Practices for some tips and tricks that may be useful.

6.8 KiB Raw Blame History