community.general.puppet – Runs puppet

Note

This plugin is part of the community.general collection (version 2.0.1).

To install it use: ansible-galaxy collection install community.general.

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

Synopsis
Requirements
Parameters
Examples

Synopsis

Runs puppet agent or apply in a reliable manner.

Requirements

The below requirements are needed on the host that executes this module.

puppet

Parameters

Parameter	Choices/Defaults	Comments
certname string		The name to use when handling certificates.
debug boolean	no ← yes	Enable full debugging.
environment string		Puppet environment to be used.
execute string		Execute a specific piece of Puppet code. It has no effect with a puppetmaster.
facter_basename string	Default: "ansible"	Basename of the facter output file.
facts dictionary		A dict of values to pass in as persistent external facter facts.
logdest string	all stdout ← syslog	Where the puppet logs should go, if puppet apply is being used. `all` will go to both `stdout` and `syslog`.
manifest string		Path to the manifest file to run puppet apply on.
modulepath string		Path to an alternate location for puppet modules.
noop boolean	no yes	Override puppet.conf noop mode. When `yes`, run Puppet agent with `--noop` switch set. When `no`, run Puppet agent with `--no-noop` switch set. When unset (default), use default or puppet.conf value if defined.
puppetmaster string		The hostname of the puppetmaster to contact.
summarize boolean	no ← yes	Whether to print a transaction summary.
tags list / elements=string		A list of puppet tags to be used.
timeout string	Default: "30m"	How long to wait for puppet to finish.
use_srv_records boolean	no yes	Toggles use_srv_records flag
verbose boolean	no ← yes	Print extra information.

Examples

- 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

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

- name: Run a manifest with debug, log to both syslog and stdout, 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

Authors

Monty Taylor (@emonty)

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