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