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

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

- 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

Status

  • This module is guaranteed to have no backward incompatible interface changes going forward. [stableinterface]
  • This module is maintained by the Ansible Community. [community]

Authors

  • Monty Taylor (@emonty)

Hint

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