doc: add steps for making a host "ansible managed"

Not all hosts have the "cm" user present; this commit adds a bit of text
to README to indicate how to bootstrap that.

Signed-off-by: Ken Dreyer <kdreyer@redhat.com>

diff --git a/README.rst b/README.rst
index 96392176be0e031685698e1ae4a89ddc14ebfcca..07e1641ff61b01c07341b06bf50ff9300980e2c9 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -63,6 +63,21 @@ You can now run ``ansible-playbook``::
 
 This will print a lot of debugging output to your console.
 
+Adding a new host to ansible
+============================
+
+Ansible runs using the "cm" shell account.
+
+Let's say you've created a new VM host using downburst. At this point you
+should have a new VM with the "ubuntu" UID present. The problem is that Ansible
+uses the "cm" user. In order to get that UID set up:
+
+1. Add your host to the inventory. Look in your lab's ``secrets`` repository,
+   in the ``ansible/inventory/`` directory, and add your new node.
+
+2. Run the ``cephlab.yml`` playbook, limited to your new host "mynewhost"::
+
+    ansible-playbook -vv --limit mynewhost cephlab.yml
 
 TODO
 ====