summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMatthew Fennell <matthew@fennell.dev>2024-01-08 22:50:39 +0000
committerMatthew Fennell <matthew@fennell.dev>2024-01-08 22:50:39 +0000
commitd7e71e34d6eb308b20b6e7fee9eb6e6a74224897 (patch)
treeec31a7ab7e7a559ce787ac459b1915f092a80ff2 /README.md
parentcdac2a163024dfb6a9d49ef004bfa3f053d2e413 (diff)
Encourage use of host_var yaml files
For now, there are not too many variables to set per host. However, this will likely change in future commits, with a greater number of variables needing to be configured. Therefore, this commit encourages the user to define these variables in a yaml file, which will be more cleanly scalable.
Diffstat (limited to 'README.md')
-rw-r--r--README.md20
1 files changed, 19 insertions, 1 deletions
diff --git a/README.md b/README.md
index d0b650b..0943edd 100644
--- a/README.md
+++ b/README.md
@@ -76,7 +76,25 @@ Create an inventory file in `inventory/staging.ini` like the following:
```ini
[xmpp_server]
-staging.koyo.haus virtual_host=staging.koyo.haus
+staging.koyo.haus
+```
+
+### Set variables in inventory files
+
+Now, create a directory like the following for each of the hosts you have
+defined: `inventory/host_vars/staging.koyo.haus/vars.yaml`
+
+```
+inventory/
+├── host_vars
+│   └── staging.koyo.haus
+│   └── vars.yaml
+└── staging.ini
+```
+
+```yaml
+certbot_email: an email address letsencrypt should use if renewal fails
+virtual_host: the domain of the JID you'd like to use, e.g. koyo.haus
```
### Run the playbook on your staging hosts