- Docs »
- puppet - Runs puppet
-
You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.
puppet - Runs puppet
- Runs puppet agent or apply in a reliable manner.
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.
|
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.
|
- 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
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.