puppet, puppet-agent, puppet-apply: add page (#6794)

pages/common/puppet-agent.md

@@ -0,0 +1,24 @@
+# puppet agent
+
+> Retrieves the client configuration from a Puppet server and applies it to the local host.
+> More information: <https://puppet.com/docs/puppet/7/man/agent.html>.
+
+- Register a node at a Puppet server and apply the received catalog:
+
+`puppet agent --test --server {{puppetserver_fqdn}} --serverport {{port}} --waitforcert {{poll_time}}`
+
+- Run the agent in the background (uses settings from `puppet.conf`):
+
+`puppet agent`
+
+- Run the agent once in the foreground, then exit:
+
+`puppet agent --test`
+
+- Run the agent in dry-mode:
+
+`puppet agent --test --noop`
+
+- Log every resource being evaluated (even if nothing is being changed):
+
+`puppet agent --test --evaltrace`