Ansible

This folder contains Ansible roles which are used to configure out bare metal servers.

Local Environment Setup

If you are on Windows, you need to install WSL and run Ansible in there, as Ansible cannot run on Windows hosts natively. Debian Stable is recommended, but any Linux distribution should work.

From the project root directory:

1. Install the pre-commit hook: pre-commit install
2. Install Poetry: apt install python3-poetry
3. Install dependencies: poetry install
4. Head to the ansible directory: cd ansible
5. Install Ansible dependencies: poetry run ansible-galaxy install -r roles/requirements.yml
6. Create a vault_passwords file and write the vault password to it
7. Configure the Ansible Vault git diff driver using git config --global diff.ansible-vault.textconv "ansible-vault view" and git config diff.ansible-vault.cachetextconv false

Testing on Virtual machines

To setup a local environment using VMs for testing, see the local_testing directory.