Модуль community.general.locale_gen — создание и удаление локалей

Примечание

Этот модуль входит в коллекцию community.general (версия 12.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать модуль в плейбуке, укажите: community.general.locale_gen.

Краткое описание
Параметры
Атрибуты
Примечания
Примеры
Возвращаемые значения

Краткое описание

Управляет локалями в системах Debian и Ubuntu.

Параметры

Параметр	Комментарии
name list / elements=string / обязательный	Название и кодировка локалей, например `en_GB.UTF-8`. До community.general 9.3.0 это была строка. Строку по-прежнему можно использовать.
state string	Должны ли локали присутствовать в системе. Варианты: `"absent"` `"present"` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: full	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевую систему.
diff_mode	Поддержка: none	В режиме diff возвращает сведения о том, что изменилось (или, возможно, должно измениться в `check_mode`).

Примечания

Примечание

В настоящее время модуль поддерживается только в системах Debian, Ubuntu и Arch Linux.
Для работы этого модуля в системах Debian и Ubuntu требуется установленный пакет locales.
Если существует /etc/locale.gen, модуль предполагает, что используется механизм glibc; если же существует /var/lib/locales/supported.d/, он предполагает, что используется механизм ubuntu_legacy; в противном случае модуль выдает ошибку.
При использовании механизма glibc модуль управляет локалями, редактируя /etc/locale.gen и запуская locale-gen.
При использовании механизма ubuntu_legacy модуль управляет локалями, редактируя /var/lib/locales/supported.d/local, а затем запуская locale-gen.
Обратите внимание: модуль проверяет доступность локали по наличию файлов /usr/share/i18n/SUPPORTED и /usr/local/share/i18n/SUPPORTED, однако файл /usr/local не поддерживается в Archlinux.
Обратите внимание: участок кода, использующий механизм ubuntu_legacy, давно не тестировался, поскольку в последних версиях Ubuntu уже используется механизм glibc. Поддержка ubuntu_legacy отсутствует, поскольку мы не можем его протестировать. Поэтому этот механизм считается устаревшим и будет удален в community.general 13.0.0.

Примеры

- 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

Возвращаемые значения

Общие возвращаемые значения описаны здесь; далее перечислены поля, уникальные для этого модуля:

Ключ	Описание
mechanism string добавлено в community.general 10.2.0	Механизм, использованный для развертывания локалей. Возвращается: success Возможные значения: `"glibc"` `"ubuntu_legacy"` Пример: `"glibc"`

Авторы

Augustus Kling (@AugustusKling)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/locale_gen_module.html