Documentation
PLEASE NOTE: This document applies to latest version and not to the latest stable release v2.21
Documentation for other releases can be found by using the version selector in the top right of any doc page.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