---
name: "puppet-secret_agent"
section: "8"
platform: "linux"
package: "puppet-common"
version: "3.7.2-4+deb8u1"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/puppet-secret_agent"
---

# puppet-secret\_agent(8)

Mimics puppet agent.

## 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