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 configuration parameter 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
configuration parameters, so you can specify
--server
<servername>, or
--run_mode <runmode> as an argument.
See the configuration file documentation at
http://docs.puppetlabs.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 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 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
