infrastructure/README.md

# Infrastructure

Ansible infrastructure playbooks/roles for the saibotk.de services.

## Requirements

Some roles may need specific python libraries etc. installed on the Ansible client (for example python-influxdb for the [roles/monitoring](roles/monitoring) role).

## Setup

Install all required roles from ansible galaxy using:
```
ansible-galaxy install -f -r requirements.yml
```

Run with your local (test) inventory:
```
ansible-playbook -i test.inventory playbooks/PLAYBOOK.yml
```

## Create new roles

When creating new roles, you can set up an initial folder structure with Ansible-Galaxy and the default skeleton folder structures defined in [.ansible/skeleton](.ansible/skeleton).
For more information check out the Ansible documentation [here](https://docs.ansible.com/ansible/devel/galaxy/dev_guide.html#using-a-custom-role-skeleton)

```
make role
```

## License

This repository is licensed under GPL-3 and many roles are derived from the awesome [infrastructure](https://git.shivering-isles.com/shivering-isles/infrastructure) repository published by [Sheogorath](https://shivering-isles.com).

Thank you, and so I hope this can be as useful to someone else as Sheogorath's repository was to me.