aboutsummaryrefslogtreecommitdiffstats
path: root/roles/root_password/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'roles/root_password/README.md')
-rw-r--r--roles/root_password/README.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/roles/root_password/README.md b/roles/root_password/README.md
new file mode 100644
index 0000000..cc18e77
--- /dev/null
+++ b/roles/root_password/README.md
@@ -0,0 +1,34 @@
+Root Password
+=============
+
+Description
+-----------
+
+The `root_password` role sets the password for the root user.
+
+
+Variables
+---------
+
+This role **accepts** the following variables:
+
+Variable | Default | Description
+---------------------|---------|------------
+`root_password` |   | Root password
+`root_password_salt` | `''` | Salt for SHA-512 hash
+
+
+Usage
+-----
+
+Example playbook:
+
+````yaml
+- name: set root password
+ hosts: all
+ roles:
+ - role: root_password
+ vars:
+ root_password: s3cret
+ root_password_salt: changeme
+````