arillso.system.groups role – Cross-platform group management

Note

This role is part of the arillso.system collection (version 0.0.34).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install arillso.system.

To use it in a playbook, specify: arillso.system.groups.

Entry point create_group_linux – Linux group management

Synopsis

  • This role manages Linux groups, handling GID assignments and system group status,

  • based on OS-specific variables.

Parameters

Parameter

Comments

groups_list

list / elements=dictionary

A list of groups with their properties to be ensured on the system.

gid

integer

The numeric group id for the group. Optional for system-generated IDs.

name

string / required

The name of the group.

non_unique

boolean

Specifies whether the GID can be non-unique. Default is ‘no’.

Choices:

  • false

  • true

state

string

Desired state of the group. Can be ‘present’ or ‘absent’. Default is ‘present’.

system

boolean

Specifies if the group is a system group. Default is false.

Choices:

  • false

  • true

Entry point create_group_windows – Windows group management

Synopsis

  • This section manages Windows group accounts, setting properties,

  • and managing group memberships based on Windows system configurations.

Parameters

Parameter

Comments

groups_list

list / elements=dictionary

A list of groups with their properties to be ensured on the system.

gid

integer

The numeric group id for the group. Optional for system-generated IDs.

name

string / required

The name of the group.

non_unique

boolean

Specifies whether the GID can be non-unique. Default is ‘no’.

Choices:

  • false

  • true

state

string

Desired state of the group. Can be ‘present’ or ‘absent’. Default is ‘present’.

system

boolean

Specifies if the group is a system group. Default is false.

Choices:

  • false

  • true

Entry point main – Cross-platform group management

Synopsis

  • This role manages group accounts on both Linux and Windows systems.

  • It applies OS-specific configurations and handles group attributes,

  • such as GID, system status, and uniqueness.

Parameters

Parameter

Comments

groups_group_list

list / elements=dictionary

A list of groups with their properties to be ensured on the system.

gid

integer

The numeric group id for the group. Optional for system-generated IDs.

name

string / required

The name of the group.

non_unique

boolean

Specifies whether the GID can be non-unique. Default is ‘no’.

Choices:

  • false

  • true

state

string

Desired state of the group. Can be ‘present’ or ‘absent’. Default is ‘present’.

system

boolean

Specifies if the group is a system group. Default is false.

Choices:

  • false

  • true

groups_host_list

list / elements=dictionary

A list of groups with their properties to be ensured on the system.

gid

integer

The numeric group id for the group. Optional for system-generated IDs.

name

string / required

The name of the group.

non_unique

boolean

Specifies whether the GID can be non-unique. Default is ‘no’.

Choices:

  • false

  • true

state

string

Desired state of the group. Can be ‘present’ or ‘absent’. Default is ‘present’.

system

boolean

Specifies if the group is a system group. Default is false.

Choices:

  • false

  • true

groups_list

list / elements=dictionary

A list of groups with their properties to be ensured on the system.

gid

integer

The numeric group id for the group. Optional for system-generated IDs.

name

string / required

The name of the group.

non_unique

boolean

Specifies whether the GID can be non-unique. Default is ‘no’.

Choices:

  • false

  • true

state

string

Desired state of the group. Can be ‘present’ or ‘absent’. Default is ‘present’.

system

boolean

Specifies if the group is a system group. Default is false.

Choices:

  • false

  • true