group

Collection: builtin

Full Name: parallax.builtin.group

Aliases: ansible.builtin.group, group

Synopsis

Create, modify and remove Unix groups

Parameters

NameTypeRequiredDefaultDescription
namestringyesName of the group to manage
statestringpresentWhether the group should exist or not
gidintOptional GID to set for the group
systemboolfalseIndicates if group is a system group
forceboolfalseWhether to delete a group even if it is the primary group of a user
localboolfalseForces use of local command alternatives
non_uniqueboolfalseAllows changing group ID to non-unique value
gid_minintSets GID_MIN for group creation
gid_maxintSets GID_MAX for group creation

Example

- name: Create a system group for the service
  group:
    name: app
    gid: 3000
    system: true
    state: present