community.general.locale_gen module – Creates or removes locales

Note

This module is part of the community.general collection (version 9.4.0).

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 community.general.

To use it in a playbook, specify: community.general.locale_gen.

Synopsis

  • Manages locales by editing /etc/locale.gen and invoking locale-gen.

Parameters

Parameter

Comments

name

list / elements=string / required

Name and encoding of the locales, such as en_GB.UTF-8.

Before community.general 9.3.0, this was a string. Using a string still works.

state

string

Whether the locale shall be present.

Choices:

  • "absent"

  • "present" ← (default)

Attributes

Attribute

Support

Description

check_mode

Support: full

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: none

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

  • This module does not support RHEL-based systems.

Examples

- name: Ensure a locale exists
  community.general.locale_gen:
    name: de_CH.UTF-8
    state: present

- name: Ensure multiple locales exist
  community.general.locale_gen:
    name:
      - en_GB.UTF-8
      - nl_NL.UTF-8
    state: present

Authors

  • Augustus Kling (@AugustusKling)