@@ -14,7 +14,7 @@ Role to manage users on a system.
14
14
* users_default_shell (default: /bin/bash) - the default shell if none is
15
15
specified for the user.
16
16
* users_create_homedirs (default: true) - create home directories for new
17
- users. Set this to false is you manage home directories separately.
17
+ users. Set this to false if you manage home directories separately.
18
18
19
19
## Creating users
20
20
@@ -25,22 +25,22 @@ users to be on certain machines.
25
25
The following attributes are required for each user:
26
26
27
27
* username - The user's username.
28
- * name - The full name of the user (gecos field)
29
- * home - the home directory of the user to create (optional, defaults to /home/username)
28
+ * name - The full name of the user (gecos field).
29
+ * home - The home directory of the user to create (optional, defaults to /home/username).
30
30
* uid - The numeric user id for the user (optional). This is required for uid consistency
31
31
across systems.
32
32
* gid - The numeric group id for the group (optional). Otherwise, the
33
- uid will be used
33
+ uid will be used.
34
34
* password - If a hash is provided then that will be used, but otherwise the
35
- account will be locked
35
+ account will be locked.
36
36
* update_password - This can be either 'always' or 'on_create'
37
37
- 'always' will update passwords if they differ. (default)
38
38
- 'on_create' will only set the password for newly created users.
39
- * group - optional primary group override
40
- * groups - a list of supplementary groups for the user.
41
- * append - if yes, will only add groups, not set them to just the list in groups (optional).
42
- * profile - a string block for setting custom shell profiles
43
- * ssh_key - This should be a list of ssh keys for the user (optional). Each ssh key
39
+ * group - Optional primary group override.
40
+ * groups - A list of supplementary groups for the user.
41
+ * append - If yes, will only add groups, not set them to just the list in groups (optional).
42
+ * profile - A string block for setting custom shell profiles.
43
+ * ssh_key - This should be a list of SSH keys for the user (optional). Each SSH key
44
44
should be included directly and should have no newlines.
45
45
* generate_ssh_key - Whether to generate a SSH key for the user (optional, defaults to no).
46
46
0 commit comments