puppet – Runs puppet
puppet – Runs puppet
New in version 2.0.
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 - added in 2.1 |
The name to use when handling certificates. | |
debug - added in 2.7 |
Enable full debugging | |
environment - |
Puppet environment to be used. | |
execute - added in 2.1 |
Execute a specific piece of Puppet code. It has no effect with a puppetmaster. | |
facter_basename - |
Default: "ansible" |
Basename of the facter output file. |
facts - |
A dict of values to pass in as persistent external facter facts. | |
logdest - added in 2.1 |
|
Where the puppet logs should go, if puppet apply is being used. |
manifest - |
Path to the manifest file to run puppet apply on. | |
modulepath - added in 2.4 |
Path to an alternate location for puppet modules. | |
puppetmaster - |
The hostname of the puppetmaster to contact. | |
summarize - added in 2.7 |
Whether to print a transaction summary | |
tags - added in 2.1 |
A comma-separated list of puppet tags to be used. | |
timeout - |
Default: "30m" |
How long to wait for puppet to finish. |
verbose - added in 2.7 |
Print extra information |
Examples
- name: Run puppet agent and fail if anything goes wrong
puppet:
- name: Run puppet and timeout in 5 minutes
puppet:
timeout: 5m
- name: Run puppet using a different environment
puppet:
environment: testing
- name: Run puppet using a specific certname
puppet:
certname: agent01.example.com
- name: Run puppet using a specific piece of Puppet code. Has no effect with a puppetmaster
puppet:
execute: include ::mymodule
- name: Run puppet using a specific tags
puppet:
tags: update,nginx
- name: Run a manifest with debug, log to both syslog and stdout, specify module path
puppet:
modulepath: /etc/puppet/modules:/opt/stack/puppet-modules:/usr/share/openstack-puppet/modules
logdest: all
manifest: /var/lib/example/puppet_step_config.pp
Status
- This module is guaranteed to have no backward incompatible interface changes going forward. [stableinterface]
- This module is maintained by the Ansible Community. [community]
Authors
- Monty Taylor (@emonty)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/puppet_module.html