summaryrefslogtreecommitdiff
path: root/roles/sane_debian_system/subplot.md
diff options
context:
space:
mode:
authorLars Wirzenius <liw@liw.fi>2021-03-31 08:53:50 +0300
committerLars Wirzenius <liw@liw.fi>2021-03-31 08:53:50 +0300
commit1c461a80c791253ef27be98ccf8c88fe6133a4f2 (patch)
treede8669f11e1d6f483cd3cf76ca91cb7c43a60758 /roles/sane_debian_system/subplot.md
parentf1a3416db0fbf0b62af8c45cd11f66018d00ff41 (diff)
downloaddebian-ansible-1c461a80c791253ef27be98ccf8c88fe6133a4f2.tar.gz
feat! default sane_debian_hostname to inventory hostname
Doesn't break anything if hostname was already set, but just in case, bump version number, which means any users of this role need to be upgraded.
Diffstat (limited to 'roles/sane_debian_system/subplot.md')
-rw-r--r--roles/sane_debian_system/subplot.md28
1 files changed, 26 insertions, 2 deletions
diff --git a/roles/sane_debian_system/subplot.md b/roles/sane_debian_system/subplot.md
index 087ae44..dc22679 100644
--- a/roles/sane_debian_system/subplot.md
+++ b/roles/sane_debian_system/subplot.md
@@ -3,6 +3,13 @@
This role sets up a Debian system so that it can be managed with
Ansible in a reasonable way.
+## Version history
+
+### Version 2
+
+* `sane_debian_hostname` defaults to the inventory hostname. This
+ means it's not necessary to set it if the default is sufficient.
+
## Minimally sane Debian system
~~~scenario
@@ -20,12 +27,29 @@ and the host has saneone in /etc/hosts for 127.0.1.1
~~~
~~~{#sane1.yml .file .yaml}
-sane_debian_system_version: 1
+sane_debian_system_version: 2
sane_debian_system_codename: buster
sane_debian_system_hostname: saneone
~~~
+## Uses inventory hostname by default
+
+~~~scenario
+given a host running Debian
+when I use role sane_debian_system
+and I use variables from sane-without-hostname.yml
+and I run the playbook
+then the host has the sudo package installed
+and the host has hostname debian-ansible-test
+~~~
+
+~~~{#sane-without-hostname.yml .file .yaml}
+sane_debian_system_version: 2
+
+sane_debian_system_codename: buster
+~~~
+
## Checks that debian codename is set
~~~scenario
@@ -38,5 +62,5 @@ and stdout contains "sane_debian_system_codename"
~~~
~~~{#sane2.yml .file .yaml}
-sane_debian_system_version: 1
+sane_debian_system_version: 2
~~~