New in version 2.0.
The below requirements are needed on the host that executes this module.
| 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. all will go to both stdout and syslog. |
| 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 |
- 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
This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/puppet_module.html