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. | |
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. | |
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. |
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
Status
This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.
Maintenance
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.
Author
- Monty Taylor (@emonty)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/puppet_module.html