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 | Default:
None
|
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.
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.5/modules/puppet_module.html