Run a job
In AWX you launch a job template and watch a text log. Here you launch a run and watch a live host-by-task matrix, and the run can drive any tool, not only Ansible.
Launch from the UI
- Open Runs and select Launch run.
- Pick the tool. For Ansible, choose a playbook and an inventory. For Bash, Terraform, or Python, enter the script, or the working directory for Terraform.
- Optional: turn on Dry run to preview without making changes. Ansible runs
--check, Terraform runsplan, and Bash and Python run a syntax check. - Select Launch. The run detail page paints each host and task as it happens, with drill-down into stdout, stderr, return code, and diff.
Split it across hosts
Set a shard count of two or more and Yardmaster splits the run across your inventory, balanced by each host's measured duration from recent runs, then rolls the shards up into one matrix. This is AWX job slicing, sized by real cost rather than a flat count.
Do it from the API
curl -s -X POST localhost:8080/runs \
-H 'content-type: application/json' \
-d '{"tool":"bash","command":"echo hello from yardmaster"}'
For an Ansible run, send playbook and inventory instead of command, and add "shards": 3 to
split it. See the HTTP API for every field.
Next: save this launch as a preset in save a template.
