This project aims to provide a simple Ansible-related build feature for TeamCity. The key features are:
- custom callback plugin which allows to:
- inject TeamCity service messages and format the build log
- provide custom report tab to show the changed tasks and hosts where the changes happened
- raise build problem for any failed task
- raise build problem in case changes are detected (e.g. dry run scenario)
Example of the report tab (to be prettified):
The usage scenario is to make a dry run as a first build, allow to check it manually easier and, if the changes look good, apply them in the second build. Synergises with Manual Approval feature introduced in 2022.04.
Callback plugin requires Ansible with Python 3.X.
Create a build problem for any detected change: for any detected change, create a build problem to fail the build.
Force colored log: enforce the colored output for Ansible commands.
The runner supplies a simple callback plugin which affects the output of ansible-playbook, and will inject the following environment variables into the execution context:
ANSIBLE_STDOUT_CALLBACK=teamcity_callback— this will override the stdout callback plugin with the one provided by this runner.ANSIBLE_CALLBACK_PLUGINS— the path will be updated to also include the directory with the above plugin on the agent side.