Running tasks in PE
Use the orchestrator to set up jobs in the console or on the command line and run Bolt tasks across systems in your infrastructure.
Running a task does not update your Puppet configuration. If you run a task that changes the state of a resource that Puppet is managing, a subsequent Puppet run changes the state of that resource back to what is defined in your Puppet configuration. For example, if you use a task to update the version of a managed package, the version of that package is reset to whatever is specified in a manifest on the next Puppet run.
Note: If you have set up compilers and you want to use tasks, you must
either set
primary_uris
or server_list
on agents to point to your compilers. This setting is
described in the section on configuring compilers for orchestrator scale.-
Running tasks from the console
Run ad-hoc tasks on targeted nodes to upgrade packages, restart services, or perform any other type of single-action executions on nodes in your inventory. -
Running tasks from the command line
Use thepuppet task run
command to run tasks on agent nodes. -
Stop a task in progress
You can stop a task that is currently running if, for example, you realize you need to adjust your PQL query or edit the task run parameters. -
Inspecting tasks
You can inspect task documentation, outcomes of task jobs, a list of installed tasks, and a list of tasks you have permission to run.
Related information