PUPPET-SECRET_AGENT(8) Puppet manual PUPPET-SECRET_AGENT(8)NAME
puppet-secret_agent - Mimics puppet agent.
SYNOPSIS
puppet secret_agent action
DESCRIPTION
This subcommand currently functions as a proof of concept, demonstrat‐
ing how the Faces API exposes Puppet´s internal systems to application
logic; compare the actual code for puppet agent. It will eventually
replace puppet agent entirely, and can provide a template for users who
wish to implement agent-like functionality with non-standard applica‐
tion logic.
OPTIONS
Note that any configuration parameter that´s valid in the configuration
file is also a valid long argument, although it may or may not be rele‐
vant to the present action. For example, server and run_mode are valid
configuration parameters, so you can specify --server <servername>, or
--run_mode <runmode> as an argument.
See the configuration file documentation at http://docs.puppet‐
labs.com/references/stable/configuration.html for the full list of
acceptable parameters. A commented list of all configuration options
can also be generated by running puppet with --genconfig.
--render-as FORMAT
The format in which to render output. The most common formats
are json, s (string), yaml, and console, but other options such
as dot are sometimes available.
--verbose
Whether to log verbosely.
--debug
Whether to log debug information.
ACTIONS
synchronize - Run secret_agent once.
SYNOPSIS
puppet secret_agent
DESCRIPTION
Mimics a single run of puppet agent. This action does not cur‐
rently daemonize, but can download plugins, submit facts,
retrieve and apply a catalog, and submit a report to the puppet
master.
RETURNS
Verbose logging from the completed run. When used from the Ruby
API: returns a Puppet::Transaction::Report object.
NOTES
This action requires that the puppet master´s auth.conf file
allow save access to the facts REST terminus. Puppet agent does
not use this facility, and it is turned off by default. See
http://docs.puppetlabs.com/guides/rest_auth_conf.html for more
details.
EXAMPLES
synchronize
Trigger a Puppet run with the configured puppet master:
$ puppet secret_agent
COPYRIGHT AND LICENSE
Copyright 2011 by Puppet Labs Apache 2 license; see COPYING
Puppet Labs, LLC January 2013 PUPPET-SECRET_AGENT(8)