Run Puppet on a node group

An orchestrator job can target all nodes in a specific node group.

To schedule a recurring Puppet run or schedule a single run for a later time or date, refer to Schedule a Puppet run.

1. In the console, in the Jobs page, click Run Puppet.
2. Optional: In the Job description field, provide a description. The text you enter here appears on the job list and job details pages.
3. Under Environment, select one of the following options to specify the environment you want the nodes to run in:
   • Run nodes in their own assigned environment: Nodes run in the environment specified by the Node Manager or their puppet.conf file.
   • Select an environment for nodes to run in: Nodes run in the environment you select from the dropdown list. Nodes can run in an environment if their environment is agent-specified or if they're classified in that environment by the node manager.
4. Under Run options, select the run mode for the job. The default run mode for a job always attempts to enforce new catalogs on nodes. To change the run mode, use the following selections:
   • No-op: Simulate a Puppet run on all nodes in the job without enforcing a new catalog.
   • Debug: Print all debugging messages.
   • Trace: Print stack traces on some errors.
   • Eval-trace: Display how long it took for each step to run.
   • Override noop = true configuration: If any nodes in the job have noop = true set in their puppet.conf files, Puppet ignores that setting and enforce a new catalog on those nodes. This setting corresponds to the --no-noop flag available on the orchestrator CLI.
5. Click Next: Select nodes.
6. Under Node selection method, from the dropdown select Node group.
7. From the Choose a node group dropdown, type or select a node group, and click Select.
8. Optional: To convert the list of nodes captured by the selected node group into a static list of nodes, click Convert query to static node list.
   If you select this option, the job target becomes a node list. You can add or remove nodes from the node list before running the job, but you cannot edit the query.
9. When you have selected the node group containing the nodes you want to target or have created a static list of targeted nodes, click Next: Review and schedule.
10. Schedule the job or, to start the Puppet run immediately, click Run job.

    You can view the job status and a list of previous and scheduled jobs on the Jobs page.

    To rerun a job, click on the relevant job ID and click Run again, choosing whether to rerun it on all nodes or only the nodes that failed during the initial run.