puppet – Runs puppet

From Get docs
Ansible/docs/2.7/modules/puppet module


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

  • 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

Authors

  • 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.7/modules/puppet_module.html