ansible/README.md

68 lines
4 KiB
Markdown
Raw Normal View History

2012-07-26 00:25:20 +02:00
Ansible Resources
2012-07-26 00:03:43 +02:00
=================
2012-07-26 00:34:14 +02:00
User contributed playbooks, modules, and articles. This is a small curated list, but growing. Everyone is encouraged to add to this document,
submit a pull request at http://github.com/ansible/ansible-resources.
2012-07-26 00:25:20 +02:00
Ansible Modules
===============
2012-07-26 00:34:14 +02:00
Ansible modules are a way of adding new client-side logic to ansible. They can be written in any language.
2012-07-26 00:28:21 +02:00
* [Official "core" ansible modules](http://ansible.github.com/modules.html) - various
* [mercurial](https://github.com/bradobro/ansible-module-mercurial) - bradobro
* [zypper (bash module example)](https://github.com/jpmens/ansible-zypp) - jp_mens
* [lineinfile](https://github.com/azemon/ansible/blob/lineinfile/library/lineinfile) - azemon
* [homebrew](https://gist.github.com/3170079) - swehack
2012-07-26 00:25:20 +02:00
Python modules using 0.6 and later can use the common "AnsibleModule" class to dramatically reduce
2012-07-26 00:34:14 +02:00
the amount of boilerplate code required. Not all modules above yet take advantage of this feature.
See the official documentation for more details.
2012-07-26 00:25:20 +02:00
Selected Playbooks
==================
2012-07-26 00:34:14 +02:00
[Playbooks](http://ansible.github.com/playbooks.html) are ansible's configuration management language. It should
be easy to write your own from scratch for most applications, but it's always helpful to look at what others have
done for reference.
2012-07-26 00:28:21 +02:00
* [Hadoop](https://github.com/jkleint/ansible-contrib/tree/master/playbooks/hadoop_jkleint) - jkleint
2012-07-26 00:28:46 +02:00
* [LAMP](https://github.com/fourkitchens/server-playbooks) - [Four Kitchens](http://fourkitchens.com)
2012-07-26 00:34:14 +02:00
* [Ganglia (demo)](https://github.com/mpdehaan/ansible-examples) - mpdehaan
2012-07-26 00:54:20 +02:00
* [Nginx](http://www.capsunlock.net/2012/04/ansible-nginx-playbook.html) - cocoy
2012-07-26 00:25:20 +02:00
2012-07-26 01:29:13 +02:00
Scripts
=======
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.
* [virt-install + Ansible provisioning](http://fedorapeople.org/cgit/skvidal/public_git/scripts.git/tree/ansible/start-prov-boot.py) - skvidal
* [rebooting hosts](http://fedorapeople.org/cgit/skvidal/public_git/scripts.git/tree/ansible/host-reboot) - skvidal
* [EC2 external inventory](https://github.com/ansible/ansible/blob/devel/examples/scripts/ec2_external_inventory.py) - pas256
* [Cobbler external inventory (demo)](https://github.com/ansible/ansible/blob/devel/examples/scripts/cobbler_external_inventory.py)
* [uptime (API demo)](https://github.com/ansible/ansible/blob/devel/examples/scripts/uptime.py) - mpdehaan
2012-07-26 00:25:20 +02:00
Blogs & Articles
================
2012-07-26 00:28:21 +02:00
* [HighScalability.com](http://highscalability.com/blog/2012/4/18/ansible-a-simple-model-driven-configuration-management-and-c.html) - mpdehaan
* [ColoAndCloud.com interview](http://www.coloandcloud.com/editorial/an-interview-with-ansible-author-michael-dehaan/) - mpdehaan
* [dzone](http://server.dzone.com/articles/ansible-cm-deployment-and-ad) - Mitch Pronschinske
* [Configuration Management With Ansible](http://jpmens.net/2012/06/06/configuration-management-with-ansible/) - jp_mens
* [Shell Scripts As Ansible Modules](http://jpmens.net/2012/07/05/shell-scripts-as-ansible-modules/) - jp_mens
* [Ansible Facts](http://jpmens.net/2012/07/15/ansible-it-s-a-fact/) - jp_mens
2012-07-26 00:54:20 +02:00
* [Infrastructure as Data](http://www.capsunlock.net/2012/04/ansible-infrastructure-as-data-not-infrastructure-as-code.html) - cocoy
* [Ansible Pull Mode](http://www.capsunlock.net/2012/05/using-ansible-pull-and-user-data-to-setup-ec2-or-openstack-servers.html) - cocoy
2012-07-26 00:25:20 +02:00
Disclaimer
==========
Modules and playbooks here may not be using the latest in Ansible features. When in doubt to the features of
2012-07-26 00:34:14 +02:00
a particular version of Ansbile, always consult [ansible.github.com](http://ansible.github.com) and in particular
see [Best Practices](http://ansible.github.com/bestpractices.html) for some tips and tricks that may be useful.
2012-07-26 00:25:20 +02:00
2012-07-26 00:28:21 +02:00
Ansible is (C) 2012, [Michael DeHaan](http://twitter.com/laserllama) and others and is available under the GPLv3 license. Content here is as specified
2012-07-26 00:25:20 +02:00
by individual contributors.