action-ansible-playbook/README.md

# 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

```yaml
- name: Run playbook
  uses: dawidd6/action-ansible-playbook@v2
  with:
    playbook: deploy.yml
    directory: ./
    key: ${{secrets.SSH_PRIVATE_KEY}}
    inventory: |
      [all]
      example.com

      [group1]
      example.com
    vault_password: ${{secrets.VAULT_PASSWORD}}
    options: |
      --limit group1
      --extra-vars hello=there
      --verbose
```