fixing documentation

README.md

@@ -2,6 +2,52 @@
 
 this is currently under construction and working on a minimal viable demo for testing purposes
 
+# How to use
+
+## Fill in login information for Ansible Tower
+
+Modify the `tower_login_info.yml` that is included in this repo with the username, password and IP address (or DNS name) of your Ansible Tower
+
+## Choose your demo
+
+Modify the `choose_demo.yml` that is included in this repo with demo name you want.
+
+## Run Ansible Playbook
+
+```
+ansible-playbook playbooks/install_demo.yml -e @choose_demo.yml -e @tower_login_info.yml
+```
+
+# Demo Repository
+
+<table">
+  <tr>
+    <th>Demo Name</th>
+    <th>Description</th>
+    <th>Workshop Types</th>
+  </tr>
+  <tr>
+    <td>Deploy Application</td>
+    <td>simple survey to install yum applications on Linux</td>
+    <td>
+    <ul>
+    <li>f5</li>
+    <li>rhel</li>
+    </ul>
+    </td>
+  </tr>
+  <tr>
+    <td>Openscap</td>
+    <td>Create HTML report using SCAP Security Guide (SSG)</td>
+    <td>
+    <ul>
+    <li>f5</li>
+    <li>rhel</li>
+    </ul>
+    </td>
+  </tr>
+</table>
+
 # Contribute
 
 please refer to the [contribute.md](docs/contribute.md) documentation included in this collection.

choose_demo.yml

@@ -1,8 +1,9 @@
 ---
-## chose demo or choose all
+## example file for how to choose a demo
+## chose specific demo or choose all
 
-#example that installs just the deploy_application job template
-#demo: deploy_application
+#SPECIFIC - example that installs just the deploy_application job template
+demo: deploy_application
 
-#example that installs all demos
-demo: all
+#ALL - example that installs all demos
+# demo: all

roles/install_demo/tasks/main.yml

@@ -14,3 +14,8 @@
 - name: install all job templates
   include: add_job_template.yml
   loop: "{{ demos|dict2items }}"
+  when: demo == "all"
+
+- name: install single job template
+  include: single_job_template.yml
+  when: demo != "all"

roles/install_demo/tasks/single_job_template.yml

@@ -0,0 +1,32 @@
+- name: add single job template without survey
+  tower_job_template:
+    name: "{{demos[demo].name}}"
+    job_type: "{{demos[demo].job_type}}"
+    inventory: "{{demos[demo].inventory}}"
+    project: "{{demos[demo].project}}"
+    playbook: "{{demos[demo].playbook}}"
+    credential: "{{demos[demo].credential}}"
+    survey_enabled: "{{demos[demo].survey_enabled}}"
+    tower_username: "{{my_tower_username}}"
+    tower_password: "{{my_tower_password}}"
+    tower_host: "{{my_tower_host}}"
+    validate_certs: no
+  when:
+    - not demos[demo].survey_enabled
+
+- name: add single job template with survey
+  tower_job_template:
+    name: "{{demos[demo].name}}"
+    job_type: "{{demos[demo].job_type}}"
+    inventory: "{{demos[demo].inventory}}"
+    project: "{{demos[demo].project}}"
+    playbook: "{{demos[demo].playbook}}"
+    credential: "{{demos[demo].credential}}"
+    survey_enabled: "{{demos[demo].survey_enabled}}"
+    survey_spec: "{{demos[demo].survey_spec}}"
+    tower_username: "{{my_tower_username}}"
+    tower_password: "{{my_tower_password}}"
+    tower_host: "{{my_tower_host}}"
+    validate_certs: no
+  when:
+    - demos[demo].survey_enabled