diff options
-rw-r--r-- | roles/polkit/README.md | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/roles/polkit/README.md b/roles/polkit/README.md new file mode 100644 index 0000000..1d45741 --- /dev/null +++ b/roles/polkit/README.md @@ -0,0 +1,36 @@ +Polkit +====== + +Description +----------- + +The `polkit` role simply adds a [polkit rule](https://www.freedesktop.org/software/polkit/docs/latest/polkit.8.html) +to allow a given group to perform privleged operations. + +The only time `polkit` escalation must be used (rather than `sudo`) seems to be +when performing privileged operations from the GNOME interface. + + +Variables +--------- + +This role **accepts** the following variables: + +Variable | Default | Description +---------------------------------|-----------|------------ +`polkit_admin_group` | `wheel` | Group name for system administrators + +This role **exports** the following variables: + +Usage +----- + +Example playbook: + +````yaml +- hosts: all + roles: + - role: polkit + vars: + polkit_admin_group: sysadmins +```` |