This directory contains an ansible set up for the wikiapiary.com wiki.
We use ansible to deploy the system. These secrets that need to be deployed on the server are expected to be set in environment variables on the control node. See the file environment.yaml for a list of the variables that need to be set and an explanation of them.
You will need the following software installed:
While not required, you may find that installing direnv and configuring the hook for it so that the .envrc file in a directory is read is helpful. If you do that, you can store your secrets in your .gitignore‘d .env file and the included .envrc file will use your use it to populate your environment with the secrets that that are expected here.
Update dev-hosts.yaml to point to the hosts you want to use during testing. Alternatively, you can create your own inventory file in the inventory subdirectory and point to it with the INVENTORY
environment variable. For example, if you create an inventory file in the inventory subdirectory named sam-test-file.yaml
, then you would set your INVENTORY
environment variable to sam-test-file.yaml
.
All you should need to do is run make
. Your environment will be checked and the the ansible playbook in main.yaml will be run against your dev environment.
Once you have confirmed the playbook is working against your testing environment, you can reinvoke make with the production inventory file like this:
make INVENTORY=hosts.yaml
Bugs should be filed as issues on the WikiApiary/deploy github project.