PUPPET-MASTER(8)

📦
version 5.5.22 · 2 versions
, in ubuntu jammy

💖 PUPPET-MASTER 💖

okay so bestie, welcome to puppet-master, section 8 of the Puppet manual 🎀 this is the puppet master daemon and she is THE main character, fr fr 👑

✨ NAME ✨

puppet-master — the puppet master daemon. that's her. that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

The central puppet server. Functions as a certificate authority by default. no cap, she's the boss of certs right out of the box 🔥

🦋 USAGE 🦋

here's how you summon her:

puppet master [-D|--daemonize|--no-daemonize] [-d|--debug] [-h|--help]
[-l|--logdest syslog|FILE|console] [-v|--verbose] [-V|--version]
[--compile NODE-NAME]

🌈 DESCRIPTION 🌈

This command starts an instance of puppet master, running as a daemon and using Ruby's built-in Webrick webserver. yep, Webrick, she's built right into Ruby 🍓

Puppet master can also be managed by other application servers; when this is the case, this executable is not used. so like, if another app server is running the show, you don't touch this one. she stays unbothered 💅

💖 OPTIONS 💖

quick heads up before we dive in, and this part is important bestie: any Puppet setting that's valid in the configuration file is also a valid long argument. so for example, 'server' is a valid setting, which means you can pass '--server servername' as an argument. iconic, right? 😌

and boolean settings? they translate into '--setting' and '--no-setting' pairs. two for one deal ✨

See the configuration file documentation at https://puppet.com/docs/puppet/latest/configuration.html for the full list of acceptable settings. A commented list of all settings can also be generated by running puppet master with '--genconfig'. go peek if you're curious, she's not gatekeeping 💜
  • --daemonize — Send the process into the background. This is the default. (This is a Puppet setting, and can go in puppet.conf. Note the special 'no-' prefix for boolean settings on the command line.) she's an independent woman, she goes in the background by default 🫶
  • --no-daemonize — Do not send the process into the background. (This is a Puppet setting, and can go in puppet.conf. Note the special 'no-' prefix for boolean settings on the command line.) same deal, just the 'no-' flip, she stays right here in the foreground with you 🥺
  • --debug — Enable full debugging. everything on, all the tea, no filter ☕
  • --help — Print this help message. the classic "help me pls" move 🙈
  • --logdest — Where to send log messages. Choose between 'syslog' (the POSIX syslog service), 'console', or the path to a log file. If debugging or verbosity is enabled, this defaults to 'console'. Otherwise, it defaults to 'syslog'. pick your destination bestie, she'll drop the logs wherever you tell her 🎀

A path ending with '.json' will receive structured output in JSON format. The log file will not have an ending ']' automatically written to it due to the appending nature of logging. It must be appended manually to make the content valid JSON. okay so this one's a little sneaky — the JSON is valid-ish but that closing bracket? not written for you. you gotta append it yourself or it's not valid JSON, periodt ⚠️

  • --masterport — The port on which to listen for traffic. The default port is 8140. (This is a Puppet setting, and can go in puppet.conf.) 8140 is her home address, she's not moving 🏠
  • --verbose — Enable verbosity. she will simply say more, and honestly? good for her 💬
  • --version — Print the puppet version number and exit. quick lil flex then she dips 👋
  • --compile — Compile a catalogue and output it in JSON from the puppet master. Uses facts contained in the $vardir/yaml/ directory to compile the catalog. she pulls those facts straight out of $vardir/yaml/ and hands you a whole catalogue in JSON, slay 📦✨

⭐ EXAMPLE ⭐

puppet master

that's it. that's the whole example. simple, clean, she ate 💅

💀 DIAGNOSTICS 💀

When running as a standalone daemon, puppet master accepts the following signals. she speaks signal, fluently 🧚

  • SIGHUP — Restart the puppet master server. the classic "on my way back, refreshed" moment ✨
  • SIGINT and SIGTERM — Shut down the puppet master server. she's logging off, don't take it personally 😭
  • SIGUSR2 — Close file descriptors for log files and reopen them. Used with logrotate. this is the logrotate bestie right here, she closes the fds and reopens them like nothing happened 🔄

👑 AUTHOR 👑

Luke Kanies

Copyright (c) 2012 Puppet Inc., LLC Licensed under the Apache 2.0 License

and that's the whole page bestie!! 💜 this one came from Puppet, Inc. and it's dated <b>May 2022</b> — she's been holding it down since then, no cap. go run her, she's ready 🫶✨

📦 where this page comes from