infrastructure/README.md

35 lines
No EOL
1.2 KiB
Markdown

# 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)
```
cd roles
ansible-galaxy init ROLE_NAME
```
## 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.