puppet - Runs puppet

New in version 2.0.

Synopsis

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 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.