Marty Oehme
c5eac2a846
Removed the `site-dev.yml` playbook in favor of tagging all included roles in the main playbook. This way there are no 2 playbooks to keep manually in sync and the specific roles can still be run just like from the dev playbook by invoking the intended roles through `--tag myrole` or `--skip-tags myskippedrole`. |
||
|---|---|---|
| group_vars | ||
| host_vars | ||
| roles | ||
| .gitignore | ||
| ansible.cfg | ||
| inv-dev.yml | ||
| inv-prod.yml | ||
| inv-staging.yml | ||
| README.md | ||
| site.yml | ||
| Vagrantfile | ||
Cloudserve infrastructure
Testing
This repository comes with a test-ready setup to try out the complete site setup locally.
It uses vagrant to accomplish this and create a pretend target host.
Install vagrant on your system and to make tests repeatable also install the vagrant plugins vagrant-hosts and vagrant-hostsupdater,
which will set a static IP for the vagrant host to be reachable under.
vagrant plugin install vagrant-hosts vagrant-hostsupdater
Then you are ready to run the complete infrastructure setup locally,
simply by executing ansible-playbook site.yml.
You can of course pick and choose what should be executed with host limits, tags, group variables, and so on,
but this should provide an easy way to see if a) the playbook is working as intended and b) what it does is useful.
Deployment
Most variables to be changed should be set either through group_variables or host_variables.
For my deployment I have a production group under group_variables which houses both a vars.yml containing basic variables
(like server_domain, caddy_email, etc.)
and a vault.yml which houses everything that should ideally not be lying around in plain-text
(individual container and database passwords for the various roles etc).
To create such a file you can do ansible-vault create group_vars/<group-name>/vault.yml or
do ansible-vault edit group_vars/<group-name>/vault.yml to edit it.
Look into the default/main.yml files of the various roles to see which variables should be set or can be overridden.
The README.md files of the roles should also carry enough information about the individual variables to make sense.