puppet-plugin - Interact with the Puppet plugin system.
puppet plugin action
PUPPET-PLUGIN(8) Puppet manual PUPPET-PLUGIN(8)
NAME
puppet-plugin - Interact with the Puppet plugin system.
SYNOPSIS
puppet plugin action
DESCRIPTION
This subcommand provides network access to the puppet master's store of
plugins.
The puppet master serves Ruby code collected from the lib directories
of its modules. These plugins can be used on agent nodes to extend Fac-
ter and implement custom types and providers. Plugins are normally
downloaded by puppet agent during the course of a run.
OPTIONS
Note that any setting 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 settings, so
you can specify --server <servername>, or --run_mode <runmode> as an
argument.
See the configuration file documentation at https://docs.puppet-
labs.com/puppet/latest/reference/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
download - Download plugins from the puppet master.
SYNOPSIS
puppet plugin download
DESCRIPTION
Downloads plugins from the configured puppet master. Any plugins
downloaded in this way will be used in all subsequent Puppet
activity. This action modifies files on disk.
RETURNS
A list of the files downloaded, or a confirmation that no files
were downloaded. When used from the Ruby API, this action
returns an array of the files downloaded, which will be empty if
none were retrieved.
EXAMPLES
download
Retrieve plugins from the puppet master:
$ puppet plugin download
Retrieve plugins from the puppet master (API example):
$ Puppet::Face[:plugin, '0.0.1'].download
COPYRIGHT AND LICENSE
Copyright 2011 by Puppet Inc. Apache 2 license; see COPYING
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+--------------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+--------------------------+
|Availability | system/management/puppet |
+---------------+--------------------------+
|Stability | Volatile |
+---------------+--------------------------+
NOTES
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://github.com/puppetlabs/puppet/ar-
chive/5.5.0.tar.gz
Further information about this software can be found on the open source
community website at http://puppetlabs.com/.
Puppet, Inc. March 2018 PUPPET-PLUGIN(8)