What is a Bolt plan?
Bolt plans are Bolt's way of orchestrating complex workflows that can include running commands, scripts, Bolt tasks, and other logic. Plans allow users to run multiple tasks with one command, compute values for the input for a task, run certain tasks based on results of another task, and more. Bolt plans can be written in YAML or Puppet.
When should I use a Bolt plan?
Plans are useful when you find yourself wanting to compose multiple discreet steps together, for example running a command to install packages, then running a command to upload configuration files for those packages, then a task that starts the services those packages provide. Plans also let you compute inputs to steps in the plan, and Puppet plans have control flow logic that lets you determine whether to execute a step based on certain conditions.
How do I create a Bolt plan?
It's easiest to create a new plan inside a Bolt project.
Have Bolt create a Bolt project for you by running the bolt project init myproject command in Unix shells or the New-BoltProject -Name myproject command in PowerShell.
Then run bolt plan new myproject in Unix shells or mNew-BoltPlan -Name myproject in PowerShell.
Learn more about orchestrating workflows with plans in the Bolt documentation.