Documentation

    group

    Manage groups and group attributes.

    Attributes

    check_mode:
      support: full
    

    Parameters

    Parameter Required Type Values Description
    name true string   Name of the group to create, remove or modify.
    state   string absent
    present
    Whether the group should exist or not. [default: "present"]
    gid   integer   Group ID (GID) of the group.
    system   boolean   Create as system group (gid < 1000). [default: false]

    Example

    - group:
        name: docker
        gid: 999
    
    - group:
        name: myservice
        system: yes
    
    - group:
        name: oldgroup
        state: absent