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

Puppet Labs, LLC                                  January 2013                            PUPPET-SECRET_AGENT(8)