Group

A role for managing groups.

Requirements

• Hosts should be bootstrapped for ansible usage (have python,...)
• Root privileges, eg become: yes
• groupadd, groupdel and groupmod should be available on the host

Role Variables

Variable	Description	Default value
group_list	List of groups (see details!)	[]
group_list_host	List of groups (see details!)	[]
group_list_group	List of groups (see details!)	[]
group_state	Default group state	present
group_system	Default group system state	no

group_list details

group_list, group_list_host and group_list_group are merged when managing the groups. You can use the host and group lists to specify groups per host or group off hosts.

The group list allows you to define which groups must be managed. Each item in the list can have following attributes:

Variable	Description	Required
name	Group name	yes
gid	Group id	no
state	Group state	no
system	System group?	no

Example group_list

group_list:
  - name: group1
  - name: group2
    gid: 1001
    system: yes
  - name: group3
    gid: 1002
    state: absent

Dependencies

None.

Example Playbook

---
- hosts: servers
  roles:
  - { role: GROG.group
      become: yes,
        group_list: [
          { name: group1,
            state: present },
          { name: group2,
            gid: 1001 }
        ]
    }

Contributing

All assistance, changes or ideas welcome!

Author

By G. Roggemans

License

MIT