diff --git a/docs/_static/ansible/edit_ansible_group.png b/docs/_static/ansible/edit_ansible_group.png new file mode 100644 index 0000000000000000000000000000000000000000..7592b1bbd81eca6c22475fc316ae683599f6d2b7 Binary files /dev/null and b/docs/_static/ansible/edit_ansible_group.png differ diff --git a/docs/_static/ansible/edit_ansible_host_vars.png b/docs/_static/ansible/edit_ansible_host_vars.png new file mode 100644 index 0000000000000000000000000000000000000000..9c0a888d9c4287866e5e5785f5c781ee4a7d2fc7 Binary files /dev/null and b/docs/_static/ansible/edit_ansible_host_vars.png differ diff --git a/docs/_static/ansible/list_ansible_groups.png b/docs/_static/ansible/list_ansible_groups.png new file mode 100644 index 0000000000000000000000000000000000000000..874e0b39a298a9e2ee2353564093327fce96a951 Binary files /dev/null and b/docs/_static/ansible/list_ansible_groups.png differ diff --git a/docs/_static/ansible/register_ansible_group.png b/docs/_static/ansible/register_ansible_group.png new file mode 100644 index 0000000000000000000000000000000000000000..0a62dd1fac60a98216823b6c4a31301b0b990a7f Binary files /dev/null and b/docs/_static/ansible/register_ansible_group.png differ diff --git a/docs/network.rst b/docs/network.rst index 1aeec73e6da9f52b345abbff124131c8d2cc2561..458a07c66c8de010b70c009cf21763ef8588123b 100644 --- a/docs/network.rst +++ b/docs/network.rst @@ -73,3 +73,29 @@ If the host is an IOC (the interface should have the **IOC** tag), the form will In both case, a confirmation dialog will be displayed when you submit the form. .. image:: _static/create_vm_confirmation.png + +Ansible inventory +----------------- + +CSEntry is used as an Ansible dynamic inventory. + +Ansible groups can be created via the web interface and variables can be defined at the group or host level. +Note that group creation/edition is restricted to admin users. + +The main *Ansible groups* page lists all the groups with their variables and associated hosts. + +.. image:: _static/ansible/list_ansible_groups.png + +New group can be added from the *Register Ansible group* page: + +.. image:: _static/ansible/register_ansible_group.png + +Hosts can be associated to a group from the *Edit Ansible group* page or from the *Edit Host* page. + +.. image:: _static/ansible/edit_ansible_group.png + +.. image:: _static/ansible/edit_ansible_host_vars.png + +Variables should be entered in YAML format. `CodeMirror <http://codemirror.net>`_ is used to provide a text editor with syntax higlighting +in the register/edit pages. +Refer to Ansible documentation for more information about `YAML Syntax <https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html>`_.