Adding and removing nodes
To manage nodes with Puppet Enterprise (PE), you must approve the node’s certificate signing request. If you no longer wish to manage a node, you can remove all traces of it from PE
Managing certificate signing requests
When you install a new PE agent, the agent automatically submits a certificate signing request (CSR) to the master.
Certificate requests can be signed from the console or the command line. If DNS altnames are set up for agent nodes, you must use the command line interface to approve and reject node requests.
After approving a node request, the node doesn’t show up in the console until the next Puppet run, which can take up to 30 minutes. You can manually trigger a Puppet run if you want the node to appear immediately.
To accept or reject CSRs in the console or on the command line, you need the permission Certificate requests: Accept and reject. To manage certificate requests in the console, you also need the permission Console: View.
Managing certificate signing requests in the console
The console displays a list of nodes on the Unsigned certs page that have submitted CSRs. You can approve or deny CSRs individually or in a batch.
If you use the Accept All or Reject All options, processing could take up to two seconds per request.
When using Accept All or Reject All, nodes are processed in batches. If you close the browser window or navigate to another website while processing is in progress, only the current batch is processed.
Managing certificate signing requests on the command line
You can view, approve, and reject node requests using the command line.
$ sudo puppetserver ca list
$ sudo puppetserver ca sign <NAME>
$ sudo puppetserver ca sign (<HOSTNAME> or --all) --allow-dns-alt-names
Remove nodes
To completely remove a node from PE, you must purge the node and revoke its certificate so that it doesn’t continue to check in.
Removing a node:
Deactivates the node in PuppetDB.
Deletes the Puppet master’s information cache for the node.
Frees up the license that the node was using.
Allows you to re-use the hostname for a new node.