title: 'Role for webdocs' description: 'Quickstart and examples for demonstrating the role capabilities.'

Ansible Role: Webdocs

Status

Description

Webdocs is an Ansible Role used to setup and maintain production grade services.

Roadmap

• ROADMAP.md

References

• docs.ansible.com
• On Ansible Galaxy

Requirements

Production

• Ansible

For Local Testing

• Vagrant - (Tested using version 2.1.1)
• Vagrant plugins:
  • [vagrant-disksize (0.1.2)](https://github.com/<class 'jinja2.utils.Namespace'>/vagrant-disksize)
  • [vagrant-libvirt](https://github.com/<class 'jinja2.utils.Namespace'>/vagrant-libvirt)
  • vai (0.9.3) - For testing with multiple vms [vagrant-plugin-vai](https://github.com/<class 'jinja2.utils.Namespace'>/vagrant-plugin-vai)
  • [vagrant-vbguest (0.15.2) - Recommended vagrant-vbguest](https://github.com/<class 'jinja2.utils.Namespace'>/vagrant-vbguest)
• Virtual Box
  • Tested using Version 5.2.14 r123301 (Qt5.6.1)

Variables

defaults/main.yml

• defaults/main.yml contains all of the required variables.

project_name/site.yml example

• example_webdocs.yml may contain an example entry.

Testing

Testing with Molecule

molecule test

Testing with Vagrant

To test with all VM's defined in Vagrantfile run the following:

cd roles/webdocs
vagrant up

To run on a specific VM's

vagrant up xenial

VM's tested with Vagrant and Virtualbox

pass, fail, untested, unsupported

Authors

• [<class 'jinja2.utils.Namespace'>](mailto:<class 'jinja2.utils.Namespace'>)

License: MIT

• webdocs generated using [ansible_collection_skeleton](https://github.com/<class 'jinja2.utils.Namespace'>/ansible_collection_skeleton)