puppet secret_agent Man Page
Included in Puppet Enterprise 3.7. A newer version is available; see the version menu above for details.
NAME
puppet-secret_agent
- Mimics puppet agent.
SYNOPSIS
puppet secret_agent action
DESCRIPTION
This subcommand currently functions as a proof of concept, demonstrating 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 application logic.
OPTIONS
Note that any setting that's valid in the configuration
file is also a valid long argument, although it may or may not be
relevant to the present action. For example, server
and run_mode
are valid
settings, so you can specify --server <servername>
, or
--run_mode <runmode>
as an argument.
See the configuration file documentation at
http://docs.puppetlabs.com/puppet/latest/reference/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
, andconsole
, but other options such asdot
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 currently 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 thefacts
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