This site won't get any more updates, see github repo for most recent docs.
This role manages groups for hosts.
It currently supports these Operating Systems:
Groups will be defined within the dict variable system_groups with the attributes described in the Ansible Group module docs.
Since you don't want to define your groups for every host individually, you need to place your variable somewhere every host has access to it. In this example the system_groups variable will be defined in the scope of an Ansible group called tags_allhosts.
./group_vars/tags_allhosts.yaml
Here is an example:
system_groups:
ansiblesudo:
state: "present"
gid: 9000
sudo:
state: "present"
gid: 9001
Wheter or not a group is installed or uninstalled on a host is decided by a special variable that associates posix groups with either hosts or ansible groups. To associate a posix group to a host use system_groups_create_on_hosts and to associate with a distinct ansible group use system_groups_create_on_hostgroups.
Example:
system_groups_create_on_hostgroups:
ansiblesudo:
- "tags_allhosts"
sudo:
- "tags_allhosts"
system_groups_create_on_hosts:
ansiblesudo:
- "host1.example.com"
- "hostB.example.com"
sudo:
- "supercomputer1.example.com"
Make sure the group is associated with the hosts or hostgroups you want it to uninstall from. Set the state attribute to absent. Run your playbook.