zuul-jobs/roles/ara-report/defaults/main.yaml
David Moreau-Simard d75f5d2bf2 Refactor "emit-ara-html" into a new role: "ara-report"
We are going to provide support the ARA sqlite middleware which
provides the ability for an ARA web application to dynamically load
databases, eliminating the need for HTML generation.

HTML generation does not scale very well: it's orders of magnitude
larger than the database file containing the data and it also takes
a significant amount of time to generate the report.

It would be awkward to add dynamic database things into a role called
"emit-ara-html" and so I took the opportunity to refactor things a
little bit and make the role less prone to failures.

Note that this role was developed with the nested Ansible use case in
mind -- a job running it's own copy of Ansible with ARA should be able
to use this role to generate the report or save the database.

This role will be tested with 'base-test' first and it is expected to
make the 'emit-ara-html' role obsolete if everything works well.

Change-Id: Idedc0bfa1f0f89356b795fb9e2a16f9421a2dc18
Depends-On: I3b10c93b4902a9b45e23c227863e472697f662ef
2018-03-19 15:45:34 +00:00

27 lines
984 B
YAML

# Whether to run this role or not
# Possible values:
# - true (always)
# - false (never)
# - 'failure' (only on failure)
ara_report_run: true
# Absolute path where the ARA database is expected on the control node.
ara_database_path: "{{ zuul.executor.work_root }}/.ara/ansible.sqlite"
# Whether the report is in html format or in database format
# Possible values:
# - html
# - database
ara_report_type: 'html'
# When report_type is 'html' directory where the HTML report will be generated.
# When report_type is 'database', directory where the database is saved.
# Note that when using 'database', an ARA web application can load the database
# dynamically. See the ARA documentation for details:
# https://ara.readthedocs.io/en/latest/advanced.html#serving-ara-sqlite-databases-over-http
# This path is relative to the root of the log directory.
ara_report_path: 'ara'
# When report_type is 'html', whether to compress the ARA HTML output or not
ara_compress_html: true