Documentation

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)
    Choices:
  • stdout ←
  • syslog
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.

Author

  • Monty Taylor (@emonty)

Hint

If you notice any issues in this documentation you can edit this document to improve it.