From 6eabfa0749af9124709e89be81fc0bae3093ade5 Mon Sep 17 00:00:00 2001 From: Michael DeHaan Date: Wed, 25 Jul 2012 19:34:14 -0300 Subject: [PATCH] Update README.md --- README.md | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 59b3b09f31..7141318572 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,14 @@ Ansible Resources ================= -User contributed playbooks, modules, and articles +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 @@ -13,14 +16,19 @@ Ansible Modules * [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. Modules can be written in any language, however. +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](https://github.com/mpdehaan/ansible-examples) - mpdehaan +* [Ganglia (demo)](https://github.com/mpdehaan/ansible-examples) - mpdehaan * [Nginx](http://www.capsunlock.net/2012/04/ansible-nginx-playbook.html) - imcocoy Blogs & Articles @@ -34,16 +42,12 @@ Blogs & Articles * [Ansible Facts](http://jpmens.net/2012/07/15/ansible-it-s-a-fact/) - jp_mens * [Ansible Pull Mode](http://www.capsunlock.net/2012/05/using-ansible-pull-and-user-data-to-setup-ec2-or-openstack-servers.html) - imcocoy -Updates -======== - -To make additions to this doucment, submit a pull request at http://github.com/ansible/ansible-resources - 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) +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.