Модуль community.general.sudoers — управление файлами sudoers

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

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

Новый модуль в community.general 4.3.0

Краткое описание
Параметры
Атрибуты
Примеры

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

Этот модуль позволяет управлять файлами sudoers.

Параметры

Параметр	Комментарии
commands list / elements=string	Команды, разрешённые правилом sudoers. Можно указать несколько команд, передав список. Используйте `ALL` для всех команд.
group string	Имя группы для правила sudoers. Этот параметр нельзя использовать одновременно с `user`.
host string добавлен в community.general 6.2.0	Укажите хост, для которого предназначено правило. По умолчанию: `"ALL"`
name string / обязательный	Имя правила sudoers. Это имя используется для файла sudoers, управляемого данным правилом.
noexec boolean добавлен в community.general 8.4.0	Запрещает ли команда запускать другие команды. Варианты: `false` ← (по умолчанию) `true`
nopassword boolean	Требуется ли пароль при запуске команды с sudo. Варианты: `false` `true` ← (по умолчанию)
runas string добавлен в community.general 4.7.0	Укажите целевого пользователя, от имени которого выполняется команда или команды.
setenv boolean добавлен в community.general 6.3.0	Разрешено ли сохранять окружение при запуске команды с sudo. Варианты: `false` ← (по умолчанию) `true`
state string	Должно ли правило существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
sudoers_path string	Путь, в котором управляются файлы конфигурации sudoers. По умолчанию: `"/etc/sudoers.d"`
user string	Имя пользователя для правила sudoers. Этот параметр нельзя использовать одновременно с `group`.
validation string добавлен в community.general 5.2.0	Если указано `absent`, правило sudoers добавляется без проверки. Если указано `detect` и доступен `visudo`, правило sudoers проверяется с помощью `visudo`. Если указано `required`, для проверки правила sudoers должен быть доступен `visudo`. Варианты: `"absent"` `"detect"` ← (по умолчанию) `"required"`

Атрибуты

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

Примеры

- name: Allow the backup user to sudo /usr/local/bin/backup
  community.general.sudoers:
    name: allow-backup
    state: present
    user: backup
    commands: /usr/local/bin/backup

- name: Allow the bob user to run any commands as alice with sudo -u alice
  community.general.sudoers:
    name: bob-do-as-alice
    state: present
    user: bob
    runas: alice
    commands: ALL

- name: >-
    Allow the monitoring group to run sudo /usr/local/bin/gather-app-metrics
    without requiring a password on the host called webserver
  community.general.sudoers:
    name: monitor-app
    group: monitoring
    host: webserver
    commands: /usr/local/bin/gather-app-metrics

- name: >-
    Allow the alice user to run sudo /bin/systemctl restart my-service or
    sudo /bin/systemctl reload my-service, but a password is required
  community.general.sudoers:
    name: alice-service
    user: alice
    commands:
      - /bin/systemctl restart my-service
      - /bin/systemctl reload my-service
    nopassword: false

- name: Revoke the previous sudo grants given to the alice user
  community.general.sudoers:
    name: alice-service
    state: absent

- name: Allow alice to sudo /usr/local/bin/upload and keep env variables
  community.general.sudoers:
    name: allow-alice-upload
    user: alice
    commands: /usr/local/bin/upload
    setenv: true

- name: >-
    Allow alice to sudo /usr/bin/less but prevent less from
    running further commands itself
  community.general.sudoers:
    name: allow-alice-restricted-less
    user: alice
    commands: /usr/bin/less
    noexec: true

Авторы

Jon Ellis (@JonEllis)

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

© 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/sudoers_module.html