added an example of using get_or_make_passwd.py to the README

README.md

@@ -9,5 +9,18 @@ as our architecture document.
 We aim to make these roles as generic as possible. You should be able to start from an inventory file, an ssh key and a git clone of this and end up with a working cluster. In the longer term we might branch to include utilities to make an inventory file using NeCTAR credentials.
 
 If you need a password use get_or_make_password.py (delegated to the passwword server/localhost) to generate a random one that can be shared between nodes
+Here is an example task (taken from setting up karaage):
+- name: mysql db
+  mysql_db: name=karaage login_user=root login_password={{ sqlrootPasswd.stdout }}
+
+- name: karaage sql password
+  shell: ~/get_or_make_passwd.py karaageSQL
+  delegate_to: 127.0.0.1
+  register: karaageSqlPassword
+
+- name: mysql user
+  mysql_user: name='karaage' password={{ item }} priv=karaage.*:ALL state=present login_user=root login_password={{ sqlrootPasswd.stdout }}
+  with_items: karaageSqlPassword.stdout
+
 
 We aim to make these roles run on all common linux platforms (both RedHat and Debian derived) but at the very least they should work on a CentOS 6 install.