diff --git a/README.md b/README.md index 4636f241e91..21695516f99 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,50 @@ -ansible-resources +Ansible Resources ================= -User contributed playbooks, modules, and articles \ No newline at end of file +User contributed playbooks, modules, and articles + +Ansible Modules +=============== + +* [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 + +Python modules using 0.6 and later can use the common "AnsibleModule" class to dramatically reduce +the amount of boilerplate code required. + +Selected Playbooks +================== + +* [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 +* [Nginx][http://www.capsunlock.net/2012/04/ansible-nginx-playbook.html] - imcocoy + +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 +* [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] + +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. +