Ansible Role: MT Runner

Ansible role to run tests using MT platform.

Documentation

• docs/FACTS.mmd: Project facts and canonical state (Mindmap).
• docs/FLOWS.mmd: Flow logic of the role (Flowchart).

Requirements

This role requires:

• Ansible
• Python
• Administrative/root access on target hosts
• One of the following operating systems:
  • Debian/Ubuntu

Install

Install from Ansible Galaxy

To install this role from Ansible Galaxy, run the following command:

ansible-galaxy install ea31337.mt_runner

Install from GitHub

To install this role, you can use the following terminal command:

ansible-galaxy install git+https://github.com/EA31337/ansible-role-mt-runner.git

Role Variables

For available variables, check defaults/main.yml.

Testing

Docker

Steps to test role on Docker containers.

1. Install the current role by running the following commands in shell:

   ansible-galaxy install -r requirements.yml
   jinja2 requirements-local.yml.j2 -D "pwd=$PWD" -o requirements-local.yml
   ansible-galaxy install -r requirements-local.yml

   Alternatively, for development purposes, you can consider using symbolic link, e.g.

   mkdir -p ~/.ansible/roles
   ln -vs "$PWD" ~/.ansible/roles/ea31337.mt_runner

2. Ensure Docker service (e.g. Docker Desktop) is running.

3. Run playbook from tests/:

   ansible-playbook -i tests/inventory/docker-containers.yml tests/playbooks/docker-containers.yml

Molecule

To test using Molecule, run:

molecule test

License

GNU GPL v3

See: LICENSE