PUPPET-PLUGIN(8)

💖 PUPPET-PLUGIN(8) 💖

okay bestie, listen UP, this is puppet-plugin, from the Puppet manual, and it's literally your little backstage pass to the Puppet plugin system. no cap. 🎀

---

✨ NAME ✨

puppet-plugin — the way you Interact with the Puppet plugin system. that's it, that's the whole job. 🫶

---

🌸 SYNOPSIS 🌸

puppet plugin action

---

🦋 DESCRIPTION 🦋

so this subcommand gives you network access to the puppet master´s store of plugins. like, you're walking into the plugin vault. 💅

and here's the tea: the puppet master serves up Ruby code that it collected from the lib directories of its modules. those plugins can then be used on agent nodes to extend Facter and implement custom types and providers. iconic behaviour honestly.

normally? plugins get downloaded by puppet agent during the course of a run. that's the usual vibe. ✨

---

💅 OPTIONS 💅

okay so first, a lil heads up bestie: 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. like, server and run_mode are valid settings, so you can absolutely hit it with --server <servername>, or --run_mode <runmode> as an argument. slay. 👑

for the full list of acceptable parameters, go peek at the configuration file documentation at https://puppet.com/docs/puppet/latest/configuration.html. and if you want a commented list of all the configuration options, you can generate one by running puppet with --genconfig. cute, right?

• --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. it's giving ✨options✨.
• --verbose — whether to log verbosely. do you want the whole story? yes you do.
• --debug — whether to log debug information. maximum detail mode, no secrets kept from you. 🐛

---

🔥 ACTIONS 🔥

download — Download plugins from the puppet master. ⬇️💖

SYNOPSIS

puppet plugin download

DESCRIPTION

Downloads plugins from the configured puppet master. any plugins you download this way will be used in all subsequent Puppet activity. and yes, this action modifies files on disk — so like, it's not just reading, it's doing. 😭

RETURNS

a list of the files downloaded, or a confirmation that no files were downloaded. and when used from the Ruby API, this action returns an array of the files downloaded, which will be empty if none were retrieved. periodt. 💀

---

🌈 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.

---

and that's the whole page, bestie!! 🎀✨ written by the lovely people at Puppet, Inc., dated September 2024 — go download some plugins and be your main character self. mwah. 💖🦋🌸