Skip to content

🧪 Testing

This project includes several tasks for testing the Ansible playbooks against different architectures.

💻 AMD64

To test the playbooks on amd64 hosts, run the following command:

task amd64-test

ansible proxmox_all_lxc -i inventory/amd64.proxmox.yaml -m ansible.builtin.apt -a "update_cache=true" -b

This task will run the ansible.builtin.apt module with update_cache=true on all hosts in the inventory/amd64.proxmox.yaml inventory.

ARM64

To test the playbooks on arm64 hosts, run the following command:

task arm64-test

ansible proxmox_all_lxc -i inventory/arm64.proxmox.yaml -m ansible.builtin.apt -a "update_cache=true" -b

This task will run the ansible.builtin.apt module with update_cache=true on all hosts in the inventory/arm64.proxmox.yaml inventory.

Raspberry Pi

To test the playbooks on Raspberry Pi hosts, run the following command:

task rpis-test

ansible rpis -i inventory/rpis.yaml -m ansible.builtin.apt -a "update_cache=true" -b

This task will run the ansible.builtin.apt module with update_cache=true on all hosts in the inventory/rpis.yaml inventory.

🐳 Dockerized Testing Environment

This project includes a Dockerized testing environment in the test/ subdirectory, which allows you to test Ansible playbooks in an isolated Ubuntu container.

⚙ Configuration

  • test/Dockerfile: Defines the Docker image used for testing. It sets up an Ubuntu container with SSH access.
  • test/machine-setup.yml: The Ansible playbook that will be run inside the test container. You can modify this file to test your own playbooks and roles.

🛠 Usage

To run the Dockerized test, navigate to the test/ directory and use the task run command:

cd test/
task run

cd test/
./setup-container.sh

This will execute the setup-container.sh script, which automates the entire testing process:

  1. Creates a temporary directory.
  2. Generates a temporary SSH key.
  3. Builds and starts a Docker container.
  4. Creates a temporary Ansible inventory file.
  5. Runs the machine-setup.yml playbook inside the container.
  6. Cleans up the container and temporary files.