VERSION 2.34.0

*in this release*

✨  *new features*

   - You can now create Puppet language plans from the command line! To
   create a new plan, use the bolt plan new <name> --pp command or New-BoltPlan
   -Name <name> -Pp PowerShell cmdlet. To learn more about using this
   command, see the documentation
   
<https://puppet.com/docs/bolt/latest/experimental_features.html#bolt-plan-new-command>
   .
   - Output that includes commands will now show PowerShell cmdlets when
   running Bolt in PowerShell.

🔧  *bug fixes*

   - When using the PowerShell module, Bolt no longer wraps each command in
   single quotes. Previously, commands with complex quoting patterns could
   result in errors.
   - Bolt no longer logs output from plugin tasks to avoid printing
   sensitive information to logs.


VIEW FULL RELEASE NOTES
<https://github.com/puppetlabs/bolt/blob/main/CHANGELOG.md>

*in the works*

   - Work on bringing parallelism to plans is wrapping up and should be
   released in the near future.
   - You will soon be able to use an alternate Forge and use proxies when
   install modules using the bolt module add|install and
   Add|Install-BoltModule commands.
   - The new module management feature <https://pup.pt/bolt-modules> is
   soon moving out of experimental. Once this feature is considered stable,
   new projects created with bolt project init and New-BoltProject will
   automatically enable this feature.
   - Work is wrapping up on performance improvements on Windows.

*nuts and bolts*

Each month, we'll highlight a different Bolt feature and cover the details
of what it is, why you might want to use it, and how it can be used in your
workflows.

November's highlighted feature is: *YAML plans*!

*What are YAML plans?*

Like plans written in the Puppet language, YAML plans allow you to define
workflows that include multiple tasks. However, YAML plans are much simpler
in structure and do not require learning the Puppet language. YAML plans
allow you to define a list of steps for Bolt to execute in order, such as
executing a command, running a task, or applying resources to a Target. You
can also define and use variables or evaluate Puppet code snippets as
needed. Because YAML plans are simpler to write, they're a great way to
quickly start defining workflows for your project.


*When should I use YAML plans?*

In general, if your plan only needs to define a simple workflow that does
not require sophisticated control flow or error handling, then a YAML plan
may be preferable to a Puppet language plan. YAML plans are simple to write
and don't require any knowledge of the Puppet language, so they're also
easier for users new to Bolt to understand.

But don't worry if you start writing a YAML plan only to find that you need
some features only available to Puppet language plans. Bolt has a built-in
command that makes converting YAML plans to Puppet language plans easy.
Simply run the bolt plan convert shell command or
Convert-BoltPlan PowerShell cmdlet to convert an existing YAML plan.


*How do I start writing a YAML plan?*

The first thing you'll want to do is check out the documentation on writing
plans in YAML <https://pup.pt/bolt-yaml-plans>. Once you know how to write
a YAML plan, you can create a new plan in a module or in your project's
plans directory. Bolt has a built-in command that you can use to quickly
create a new YAML plan with the basic structure of the plan filled out for
you.

To create a new plan with Bolt, run the bolt plan new shell command or the
New-BoltPlan PowerShell cmdlet. The command will create a new plan file in
the plans directory of your project.

Happy planning!

VIEW THE DOCUMENTATION <https://pup.pt/bolt-yaml-plans>
[image: Tw] <https://twitter.com/puppetize> [image: Yt]
<https://www.youtube.com/channel/UCPfMWIY-qNbLhIrbZm2BFMQ> [image: In]
<https://www.linkedin.com/company/puppet/>

*Bolt Documentation <https://puppet.com/docs/bolt/latest/bolt.html>*

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to puppet-users+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/puppet-users/CAGdD-pX3_EiEBdOD%3DKLJu_r3UpTy1_w%3DY%2BjJ6vK2khcSdhdrag%40mail.gmail.com.

Reply via email to