Schedule a Puppet run

Schedule a job to deploy configuration changes at a particular date and time or on a recurring schedule.

If a reboot occurs or you restore a backup, scheduled Puppet jobs are rescheduled based on the last execution time. If a reboot is caused by a scheduled Puppet job running in the orchestrator, that job returns a failed status.

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 a target type.
   • Node list: Add individual nodes by name.
   • PQL Query: Use the Puppet query language to retrieve a list of nodes.
   • Node group: Select an existing node group.

   For details about the target options, refer to Run Puppet on one or more specific nodes, Run Puppet on a PQL query, and Run Puppet on a node group.

7. When you have used one of the node selection methods to select the nodes you want to target click Next: Review and schedule.
8. Under Schedule, select Later and choose a start date, time, time zone, and frequency for the job to run.
9. Optional: To repeat the job on a regular schedule, change the run frequency from Once to Hourly, Daily, or Weekly.
   If a recurring job's run overlaps with the next scheduled run, the job skips the overlapped time and doesn't run again until the next scheduled start time.
10. Click Schedule job.