Модуль community.general.puppet — запускает puppet

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

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

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

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

Надёжно запускает агент puppet или команду apply.

Требования

На узле, где выполняется этот модуль, должны быть установлены следующие компоненты.

puppet

Параметры

Параметр	Комментарии
certname string	Имя, используемое при работе с сертификатами.
confdir string добавлено в community.general 5.1.0	Путь к каталогу, содержащему файл puppet.conf.
debug boolean	Включить полную отладку. Варианты: `false` ← (по умолчанию) `true`
environment string	Используемое окружение Puppet.
environment_lang string добавлено в community.general 8.6.0	Языковая среда, используемая при запуске агента puppet. Значение по умолчанию, `C`, поддерживается во всех системах, но при использовании UTF-8 в выводе может привести к ошибкам кодировки. При возникновении проблем используйте `C.UTF-8`, `en_US.UTF-8` или другие локали с поддержкой UTF-8. Убедитесь, что выбранная локаль поддерживается в системе, где запущен агент puppet. Начиная с community.general 9.1.0 можно использовать значение `auto`; модуль попытается определить наиболее подходящую для разбора локаль. По умолчанию: `"C"`
execute string	Выполнить указанный фрагмент кода Puppet. Не действует при использовании puppetmaster.
facter_basename string	Базовое имя выходного файла facter. По умолчанию: `"ansible"`
facts dictionary	Словарь значений, передаваемых в качестве постоянных внешних фактов facter.
logdest string	Назначение журналов puppet, если используется puppet apply. `all` выводит журналы одновременно в `console` и `syslog`. `stdout` устарел и заменён на `console`. Варианты: `"all"` `"stdout"` ← (по умолчанию) `"syslog"`
manifest string	Путь к файлу манифеста, для которого нужно запустить puppet apply.
modulepath string	Путь к альтернативному расположению модулей puppet.
noop boolean	Переопределить режим noop из puppet.conf. Если задано значение `true`, запустить агент Puppet с параметром `--noop`. Если задано значение `false`, запустить агент Puppet с параметром `--no-noop`. Если значение не задано (по умолчанию), использовать значение по умолчанию или значение из puppet.conf, если оно задано. Варианты: `false` `true`
puppetmaster string	Имя хоста puppetmaster, с которым следует установить соединение.
show_diff boolean	Показывать ли подробные сведения об изменениях файлов. Варианты: `false` ← (по умолчанию) `true`
skip_tags list / elements=string добавлено в community.general 6.6.0	Список тегов puppet, которые нужно исключить.
summarize boolean	Показывать ли сводку транзакции. Варианты: `false` ← (по умолчанию) `true`
tags list / elements=string	Список используемых тегов puppet.
timeout string	Время ожидания завершения `puppet`. Этот параметр устарел и будет удалён в community.general 14.0.0. Вместо него используйте ключевое слово `timeout` на уровне задачи. Чтобы отключить это предупреждение об устаревании, задайте `timeout` значение `""`. По умолчанию: `"30m"`
use_srv_records boolean	Включает или отключает флаг use_srv_records. Варианты: `false` `true`
verbose boolean	Выводить дополнительную информацию. Варианты: `false` ← (по умолчанию) `true`
waitforlock string добавлено в community.general 9.0.0	Максимальное время, в течение которого `puppet` будет ждать завершения уже запущенного агента `puppet`, прежде чем начать работу. Если указано число без единицы измерения, оно считается количеством секунд. Допустимые единицы измерения: `m` для минут и `h` для часов.

Атрибуты

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

Примеры

- name: Run puppet agent and fail if anything goes wrong
  community.general.puppet:

- name: Run puppet and timeout in 5 minutes
  community.general.puppet:
    timeout: 5m

- name: Run puppet using a different environment
  community.general.puppet:
    environment: testing

- name: Run puppet using a specific certname
  community.general.puppet:
    certname: agent01.example.com

- name: Run puppet using a specific piece of Puppet code. Has no effect with a puppetmaster
  community.general.puppet:
    execute: include ::mymodule

- name: Run puppet using a specific tags
  community.general.puppet:
    tags:
      - update
      - nginx
    skip_tags:
      - service

- name: Wait 30 seconds for any current puppet runs to finish
  community.general.puppet:
    waitforlock: 30

- name: Wait 5 minutes for any current puppet runs to finish
  community.general.puppet:
    waitforlock: 5m

- name: Run puppet agent in noop mode
  community.general.puppet:
    noop: true

- name: Run a manifest with debug, log to both syslog and console, specify module path
  community.general.puppet:
    modulepath: /etc/puppet/modules:/opt/stack/puppet-modules:/usr/share/openstack-puppet/modules
    logdest: all
    manifest: /var/lib/example/puppet_step_config.pp

Авторы

Monty Taylor (@emonty)

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

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