Github action that allows you to trigger job or workflow templates on Ansible Tower/AWX.
Two authentication methods are supported:
Token (recommended) — Use an AWX OAuth2 token:
ansible_tower_token: ${{ secrets.ansibleToken }}Basic auth (legacy) — Use username and password:
ansible_tower_user: ${{ secrets.ansibleUser }}
ansible_tower_pass: ${{ secrets.ansiblePass }}name: Trigger Job Template on AWX
uses: bilalahmad99/github-action-trigger-awx@v2.1.0
with:
ansible_tower_token: ${{ secrets.ansibleToken }}
ansible_tower_url: ${{ secrets.ansibleUrl }}
job_template_id: "1254"
extra_vars: |
{
"environment": "dev",
"version": "1.0.0"
}name: Trigger Workflow Template on AWX
uses: bilalahmad99/github-action-trigger-awx@v2.1.0
with:
ansible_tower_token: ${{ secrets.ansibleToken }}
ansible_tower_url: ${{ secrets.ansibleUrl }}
workflow_template_id: "42"| Name | Required | Default | Description |
|---|---|---|---|
ansible_tower_url |
✅ | — | Base URL of the Tower/AWX instance; e.g. https://awx.example.net |
ansible_tower_token |
— | OAuth2 token for authentication (preferred) | |
ansible_tower_user |
— | Username for basic auth | |
ansible_tower_pass |
— | Password for basic auth | |
job_template_id |
— | ID of the job template to launch | |
workflow_template_id |
— | ID of the workflow template to launch | |
extra_vars |
❌ | {} |
JSON string of extra variables to pass to the template |
ansible_tower_retries |
❌ | 3 |
Number of times to retry an AWX API request |
ansible_tower_retry_interval |
❌ | 60000 |
Milliseconds to wait between retries |
⚠️ Eitherjob_template_idorworkflow_template_idmust be defined, but not both.
⚠️ Eitheransible_tower_tokenoransible_tower_user/ansible_tower_passmust be provided.
| Name | Description |
|---|---|
RESOURCE_NAME |
Resource name parsed from job stdout (job templates only) |
Note: Workflow template runs do not export stdout outputs.