DragonFly On-Line Manual Pages

Search: Section:  

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,
       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)

Search: Section: