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.

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 the puppet 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