docs/docker-compose: add ansible inventory to README

Added instructions that will help users
set up ansible inventory files in after they
built their local teuthology container. This
part is needed when ansible tasks are executed
when jobs are running.

Signed-off-by: Kamoltat <ksirivad@redhat.com>

diff --git a/docs/docker-compose/README.md b/docs/docker-compose/README.md
index 7fb85923c294a8a36cfedddc7c9d49abe9305c45..c8be4ab028c6e6af6f72ddfd08b92cef51eddb77 100644 (file)
--- a/docs/docker-compose/README.md
+++ b/docs/docker-compose/README.md
@@ -149,6 +149,64 @@ If the test-node is locked after adding it to paddles you can run this command t
 ./virtualenv/bin/teuthology-lock --unlock --owner initial@setup smithi022
 ```
 
+# Creating Ansible inventory
+
+In order for ansible to successfully perform certain tasks, in our teuthology container, we need
+to create and add the following line to
+`/etc/ansible/hosts/group_vars/smithi.yaml`:
+
+```bash
+volume_groups:
+  vg_nvme:
+    pvs: "/dev/nvme0n1"
+
+logical_volumes:
+  lv_1:
+    vg: vg_nvme
+    size: "89.4G"
+    scratch_dev: true
+  lv_2:
+    vg: vg_nvme
+    size: "89.4G"
+    scratch_dev: true
+  lv_3:
+    vg: vg_nvme
+    size: "89.4G"
+    scratch_dev: true
+  lv_4:
+    vg: vg_nvme
+    size: "89.4G"
+    scratch_dev: true
+  lv_5:
+    vg: vg_nvme
+    size: "14.9G"
+
+# Mounts /var/lib/ceph here
+var_lib_partition: "/dev/vg_nvme/lv_5"
+```
+Next, we need to create host machine configurations.
+For this step, I recommend you to ssh into teuthology.front.sepia.com
+and copy some of the contents in `/etc/ansible/hosts/sepia` to
+your running teuthology container (exact same directory).
+You only need these parts: `[smithi]`, `[testnodes:children]`, `[sepia:children]`
+(example is using smithi machines this subjects to change if you are using different machines).
+Tip: If you have trouble with this, just copy/paste the whole thing from teuthology.front.sepia.com!
+
+```bash
+[smithi]
+smithi001.front.sepia.ceph.com mac=xx:xx:xx:xx:xx:xx ip=xxx.xx.xx.x  ipmi=xxx.xx.xx.x  bmc=xx:xx:xx:xx:xx:xx
+.
+.
+.
+smithi205.front.sepia.ceph.com mac=xx:xx:xx:xx:xx:xx ip=xxx.xx.xx.x  ipmi=xxx.xx.xx.x  bmc=xx:xx:xx:xx:xx:xx
+
+[testnodes:children]
+smithi
+
+[sepia:children]
+smithi
+```
+
 # Run teuthology-dispatcher
 
 You can now test out your set up by running the dispatcher: