:gear: A GitHub Action for running Ansible playbooks
Last updated Jul 3, 2026
361
Stars
74
Forks
9
Issues
0
Stars/day
Attention Score
82
Language breakdown
JavaScript 100.0%
▸ Files
click to expand
README
Run Ansible playbook GitHub Action
An Action that executes given Ansible playbook on selected hosts.
Should work on any OS, if ansible-playbook command is available in PATH.
Usage
- name: Run playbook
uses: dawidd6/action-ansible-playbook@<REF>
with:
# Required, playbook filepath
playbook: deploy.yml
# Optional, directory where playbooks live
directory: ./
# Optional, ansible configuration file content (ansible.cfg)
configuration: |
[defaults]
callbacksenabled = ansible.posix.profiletasks, ansible.posix.timer
stdout_callback = yaml
nocows = false
# Optional, SSH private key
key: ${{secrets.SSHPRIVATEKEY}}
# Optional, literal inventory file contents
inventory: |
[all]
example.com
[group1] example.com # Optional, SSH known hosts file content known_hosts: | example.com ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMqqnkVzrm0SdG6UOoqKLsabgH5C9okWi0dh2l9GKJl # Optional, encrypted vault password vaultpassword: ${{secrets.VAULTPASSWORD}} # Optional, galaxy requirements filepath requirements: galaxy-requirements.yml # Optional, additional flags to pass to ansible-playbook options: | --inventory .hosts --limit group1 --extra-vars hello=there --verbose
🔗 More in this category