Continuous Integration (CI) & Testing¶
Debugging with ARA in CI¶
Frequently, the need arises to obtain more verbose ansible logging in CI. ARA is an ansible plugin that collects a large amount of execution information and can render it into a browser friendly format.
This plugin is not enabled by default because there is a per-task overhead. However, it’s possible to trigger it when trying to debug a failing job.
By adding the text #ara to the git commit message of the review, the CI jobs will enable the plugin and generate a sqlite database containing comprehensive logging. It’s possible to render an HTML version of this by using #ara_verbose. Generating the HTML is not very efficient, however, and consumes a large amount of logging resources.
Please note that git usually strips lines beginning with # from the commit message. This can be avoided by preceding the string with a space.