diff options
author | Michael DeHaan <michael.dehaan@gmail.com> | 2012-10-08 07:48:07 -0400 |
---|---|---|
committer | Michael DeHaan <michael.dehaan@gmail.com> | 2012-10-08 07:48:07 -0400 |
commit | 2eac8c6c2959188547444e386ee916e9527bf40a (patch) | |
tree | 3b75e7501980ec32692f50557b0097c400f57172 /contrib/README.md | |
parent | 41dd4a1f93cd7c95f2cb75730e334ebce712348f (diff) | |
parent | 496a2b7f56875955980092c06bcbbc448ab8228f (diff) | |
download | ansible-2eac8c6c2959188547444e386ee916e9527bf40a.tar.gz |
Merge ansible-resources tree
Diffstat (limited to 'contrib/README.md')
-rw-r--r-- | contrib/README.md | 79 |
1 files changed, 79 insertions, 0 deletions
diff --git a/contrib/README.md b/contrib/README.md new file mode 100644 index 0000000000..0365dd9e6f --- /dev/null +++ b/contrib/README.md @@ -0,0 +1,79 @@ +Ansible Resources +================= + +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. + +Ansible Modules +=============== + +Ansible modules are a way of adding new client-side logic to ansible. They can be written in any language. + +* [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 +* [homebrew](https://gist.github.com/3170079) - swehack + +Python modules using 0.6 and later can use the common "AnsibleModule" class to dramatically reduce +the amount of boilerplate code required. Not all modules above yet take advantage of this feature. +See the official documentation for more details. + +Selected Playbooks +================== + +[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. + +* [Hadoop](https://github.com/jkleint/ansible-contrib/tree/master/playbooks/hadoop_jkleint) - jkleint +* [LAMP](https://github.com/fourkitchens/server-playbooks) - [Four Kitchens](http://fourkitchens.com) +* [Ganglia (demo)](https://github.com/mpdehaan/ansible-examples) - mpdehaan +* [Nginx](http://www.capsunlock.net/2012/04/ansible-nginx-playbook.html) - cocoy +* [OpenStack](http://github.com/lorin/openstack-ansible) - lorin +* [Systems Configuration](https://github.com/cegeddin/ansible-contrib) - 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](https://github.com/ansible/ansible-plugins) + +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](https://github.com/dsander/vagrant-ansible) - dsander +* [Ansible+Vagrant Tutorial](https://github.com/mattupstate/vagrant-ansible-tutorial) - mattupstate - +* [virt-install](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 +* [uptime (API demo)](https://github.com/ansible/ansible/blob/devel/examples/scripts/uptime.py) - mpdehaan + +Blogs & Articles +================ + +* [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 +* [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 +* [Exploring Configuration Management With Ansible](http://palominodb.com/blog/2012/08/01/exploring-configuration-management-ansible) - Palamino DB - +* [You Should Consider Using SSH Based Configuration Management](http://www.lshift.net/blog/2012/07/30/you-should-consider-using-ssh-based-configuration-management) - LShift Ltd +* [Deploying Flask/uWSGI, Nginx, and Supervisorctl](http://mattupstate.github.com/python/devops/2012/08/07/flask-wsgi-application-deployment-with-ubuntu-ansible-nginx-supervisor-and-uwsgi.html) - mattupstate + +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.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. + +Ansible is (C) 2012, [Michael DeHaan](http://twitter.com/laserllama) and others and is available under the GPLv3 license. Content here is as specified +by individual contributors. + |