community.general.puppet модуль – Запускает puppet

Примечание

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

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

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

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

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

Описание

Запускает puppet агента или применение надёжным образом.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

puppet

Параметры

Параметр	Комментарии
certname string	Имя, используемое при обработке сертификатов.
confdir string добавлено в community.general 5.1.0	Путь к каталогу, содержащему файл puppet.conf.
debug boolean	Включить полную отладку. Варианты: `false` ← (default) `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"` ← (default) `"syslog"`
manifest string	Путь к файлу манифеста, на котором будет запущен puppet apply.
modulepath string	Путь к альтернативному расположению для модулей puppet.
noop boolean	Переопределить режим noop в puppet.conf. Когда `true`, запустить Puppet agent с установленным переключателем `--noop`. Когда `false`, запустить Puppet agent с установленным переключателем `--no-noop`. Если не установлено (по умолчанию), использовать значение по умолчанию или значение из puppet.conf, если оно определено. Варианты: `false` `true`
puppetmaster string	Имя хоста puppetmaster, с которым нужно связаться.
show_diff boolean	Печатать ли подробные сведения об изменениях файлов. Варианты: `false` ← (default) `true`
skip_tags list / elements=string добавлено в community.general 6.6.0	Список тегов puppet, которые нужно исключить.
summarize boolean	Печатать ли сводку транзакции. Варианты: `false` ← (default) `true`
tags list / elements=string	Список используемых тегов puppet.
timeout string	Сколько времени ждать завершения `puppet`. По умолчанию: `"30m"`
use_srv_records boolean	Переключает флаг use_srv_records. Варианты: `false` `true`
verbose boolean	Печатать дополнительную информацию. Варианты: `false` ← (default) `true`

waitforlock

string

added in community.general 9.0.0

Максимальное время, которое puppet должен ждать завершения уже запущенного puppet агента перед началом.

Если указано число без единиц измерения, оно предполагается в секундах. Допустимые единицы измерения — m для минут и h для часов.

Атрибуты

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

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/puppet_module.html