openbolt 9.0.0.pre.rc1 → 9.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1330d8e29efdcb5a955256f23e7b21341702b971d91e993004754c87573254cd
-  data.tar.gz: 3e5e5ee382f7e3df85b83c16c63ea43c5f9d35c54f25f2ef50e2589b0591e93d
+  metadata.gz: ccffb09806ff6f277b75360ff8f804592795a3712ef3150e525e947673604737
+  data.tar.gz: 42fcccda83424540f1ebee736234a00570d4060e560f05ba06864385364c39ad
 SHA512:
-  metadata.gz: f957aaf93f718c2626339bb1353d9770da0d2a6b7f16b5628ee63c124df8a45e27add34e72489a98cfb0b12d0b1414f270d1ff42669a499ce777a22a28d46d04
-  data.tar.gz: 630c9835d6cc18a6b3dd89e2cc3ace763ba22d63bbd06ff8845126ce624bc9c422672c21b30ac17c7f973713c7ba17cecffbaae9ac178ffea3470acb1df8f6cc
+  metadata.gz: e6af1fa2f0a8aeb236df11db580692c04b425c9fca04af1321636c488e3f46af603e47fee4ce604c721d0f5ff80cb2acaf076d1fd91a0ac54a76836c29981ee3
+  data.tar.gz: a76d500e92acd698776fe5b61d4be4bfe7dd5e6860025b4d0aeba2702e81dea893ec48362968908b52878e092c0c6edf25d0133b81c8d940c7e25bda81136570

data/Puppetfile

@@ -6,13 +6,13 @@ moduledir File.join(File.dirname(__FILE__), 'modules')
 
 # Core modules used by 'apply'
 mod 'puppetlabs-service', '4.0.0'
-mod 'puppet-openvox_bootstrap', '1.5.0'
+mod 'puppet-openvox_bootstrap', '1.8.0'
 mod 'puppetlabs-facts', '1.8.1'
 
 # Other core Puppet modules
-mod 'puppetlabs-inifile', '6.5.0'
-mod 'puppetlabs-apt', '11.4.0'
-mod 'puppetlabs-stdlib', '10.1.0'
+mod 'puppetlabs-inifile', '6.6.0'
+mod 'puppetlabs-apt', '11.4.1'
+mod 'puppetlabs-stdlib', '10.1.1'
 mod 'puppetlabs-powershell', '6.2.0'
 mod 'puppetlabs-pwshlib', '2.1.1'
 
@@ -31,7 +31,7 @@ mod 'puppetlabs-zone_core', '2.1.0'
 # Useful additional modules
 mod 'puppetlabs-package', '4.0.0'
 mod 'puppetlabs-puppet_conf', '3.0.0'
-mod 'puppetlabs-reboot', '6.0.0'
+mod 'puppetlabs-reboot', '6.1.0'
 
 # Task helpers
 mod 'puppetlabs-powershell_task_helper', '0.2.0'

data/bolt-modules/boltlib/lib/puppet/datatypes/result.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# For each target that you execute an action on, Bolt returns a `Result` object
+# For each target that you execute an action on, OpenBolt returns a `Result` object
 # and adds the `Result` to a `ResultSet` object. A `Result` object contains
 # information about the action you executed on the target.
 #

data/bolt-modules/boltlib/lib/puppet/datatypes/resultset.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
-# For each target that you execute an action on, Bolt returns a `Result` object
+# For each target that you execute an action on, OpenBolt returns a `Result` object
 # and adds the `Result` to a `ResultSet` object. In the case of [apply
-# actions](applying_manifest_blocks.md), Bolt returns a `ResultSet` with one or
+# actions](applying_manifest_blocks.md), OpenBolt returns a `ResultSet` with one or
 # more `ApplyResult` objects.
 #
 # @param results

data/bolt-modules/boltlib/lib/puppet/datatypes/target.rb

@@ -6,7 +6,7 @@
 #   The inventory configuration for the target. This function returns the
 #   configuration set directly on the target in `inventory.yaml` or set in
 #   a plan using `Target.new` or `set_config()`. It does not return default
-#   configuration values or configuration set in Bolt configuration files.
+#   configuration values or configuration set in OpenBolt configuration files.
 # @param facts
 #   The target's facts. This function does not look up facts for a target and
 #   only returns the facts specified in an `inventory.yaml` file or set on a
@@ -49,7 +49,7 @@
 #   The transport used to connect to the target.
 # @!method transport_config
 #   The merged configuration for the target's `transport`. This function returns
-#   configuration that includes defaults set by Bolt, configuration set in
+#   configuration that includes defaults set by OpenBolt, configuration set in
 #   `inventory.yaml`, configuration set in `bolt-defaults.yaml`, and configuration
 #   set in a plan using `set_config()`.
 # @!method user

data/bolt-modules/boltlib/lib/puppet/functions/apply_prep.rb

@@ -4,13 +4,13 @@ require 'bolt/logger'
 require 'bolt/task'
 
 # Installs the `openvox-agent` package on targets if needed, then collects facts,
-# including any custom facts found in Bolt's module path. The package is
+# including any custom facts found in OpenBolt's module path. The package is
 # installed using either the configured plugin or the `task` plugin with the
 # `openvox_bootstrap::install` task.
 #
 # Agent installation will be skipped if the target includes the `puppet-agent`
 # feature, either as a property of its transport or by explicitly setting
-# it as a feature in Bolt's inventory.
+# it as a feature in OpenBolt's inventory.
 #
 # > **Note:** Not available in apply block
 Puppet::Functions.create_function(:apply_prep) do

data/bolt-modules/boltlib/lib/puppet/functions/background.rb

@@ -9,7 +9,7 @@ Puppet::Functions.create_function(:background, Puppet::Functions::InternalFuncti
   # Returns a Future object.
   # @param name An optional name for legible logs.
   # @param block The code block to run in the background.
-  # @return A Bolt Future object
+  # @return A Future object
   # @example Start a long-running process
   #   background() || {
   #     run_task('superlong::task', $targets)

data/bolt-modules/boltlib/lib/puppet/functions/fail_plan.rb

@@ -5,7 +5,7 @@ require 'bolt/error'
 # Raises a `Bolt::PlanFailure` exception to signal to callers that the plan failed.
 #
 # Plan authors should call this function when their plan is not successful. The
-# error may then be caught by another plans `run_plan` function or in Bolt itself
+# error may then be caught by another plans `run_plan` function or in OpenBolt itself
 #
 # > **Note:** Not available in apply block
 Puppet::Functions.create_function(:fail_plan) do

data/bolt-modules/boltlib/lib/puppet/functions/get_resources.rb

@@ -2,7 +2,7 @@
 
 require 'bolt/task'
 
-# Query the state of resources on a list of targets using resource definitions in Bolt's module path.
+# Query the state of resources on a list of targets using resource definitions in OpenBolt's module path.
 # The results are returned as a list of hashes representing each resource.
 #
 # Requires the Puppet Agent be installed on the target, which can be accomplished with apply_prep

data/bolt-modules/boltlib/lib/puppet/functions/puppetdb_command.rb

@@ -6,7 +6,7 @@ require 'bolt/error'
 #
 # The `pdb_command` function only supports version 5 of the `replace_facts`
 # command. Other commands might also work, but are not tested or supported
-# by Bolt.
+# by OpenBolt.
 #
 # See the [commands endpoint](https://puppet.com/docs/puppetdb/latest/api/command/v1/commands.html)
 # documentation for more information about available commands and payload

data/bolt-modules/boltlib/lib/puppet/functions/puppetdb_query.rb

@@ -3,7 +3,7 @@
 require 'bolt/error'
 
 # Makes a query to [puppetdb](https://puppet.com/docs/puppetdb/latest/index.html)
-# using Bolt's PuppetDB client.
+# using OpenBolt's PuppetDB client.
 Puppet::Functions.create_function(:puppetdb_query) do
   # Make a query to PuppetDB.
   #

data/bolt-modules/boltlib/lib/puppet/functions/run_plan.rb

@@ -12,7 +12,7 @@ Puppet::Functions.create_function(:run_plan, Puppet::Functions::InternalFunction
   # @option args [Boolean] _catch_errors Whether to catch raised errors.
   # @option args [String] _run_as User to run as using privilege escalation.
   #   This option sets the [run-as user](privilege_escalation.md) for all
-  #   targets whenever Bolt connects to a target. This is set for all functions
+  #   targets whenever OpenBolt connects to a target. This is set for all functions
   #   in the called plan, including `run_plan()`.
   # @return [PlanResult] The result of running the plan. Undef if plan does not explicitly return results.
   # @example Run a plan
@@ -35,7 +35,7 @@ Puppet::Functions.create_function(:run_plan, Puppet::Functions::InternalFunction
   # @option args [Boolean] _catch_errors Whether to catch raised errors.
   # @option args [String] _run_as User to run as using privilege escalation.
   #   This option sets the [run-as user](privilege_escalation.md) for all
-  #   targets whenever Bolt connects to a target. This is set for all functions
+  #   targets whenever OpenBolt connects to a target. This is set for all functions
   #   in the called plan, including `run_plan()`.
   # @return [PlanResult] The result of running the plan. Undef if plan does not explicitly return results.
   # @example Run a plan
@@ -49,11 +49,34 @@ Puppet::Functions.create_function(:run_plan, Puppet::Functions::InternalFunction
   end
 
   def run_plan_with_targetspec(scope, plan_name, targets, args = {})
-    run_inner_plan(scope, plan_name, targets, args)
+    run_in_new_fiber { run_inner_plan(scope, plan_name, targets, args) }
   end
 
   def run_plan(scope, plan_name, args = {})
-    run_inner_plan(scope, plan_name, nil, args)
+    run_in_new_fiber { run_inner_plan(scope, plan_name, nil, args) }
+  end
+
+  # Load and run each plan on a new Fiber, so plans that run plans don't pile
+  # their frames onto one Fiber's small stack.
+  def run_in_new_fiber
+    # The tasks setting is off in catalog compiles, which have no executor,
+    # so run the block inline and let run_inner_plan raise its usual error.
+    return yield unless Puppet[:tasks]
+
+    # A next() in a plan's parameter defaults jumps to the run_plan() call
+    # that started the plan, which a new Fiber can't reach. Catch it on the
+    # new Fiber and throw it again on this one.
+    finished = false
+    value = Puppet.lookup(:bolt_executor).run_in_new_fiber do
+      catch(:next) do
+        result = yield
+        finished = true
+        result
+      end
+    end
+    return value if finished
+
+    throw :next, value
   end
 
   def run_inner_plan(scope, plan_name, targets, args = {})

data/bolt-modules/boltlib/lib/puppet/functions/wait.rb

@@ -8,7 +8,7 @@ require 'bolt/logger'
 # > **Note:** Not available in apply block
 Puppet::Functions.create_function(:wait, Puppet::Functions::InternalFunction) do
   # Wait for Futures to finish.
-  # @param futures A Bolt Future object or array of Bolt Futures to wait on.
+  # @param futures A Future object or array of Futures to wait on.
   # @param options A hash of additional options.
   # @option options [Boolean] _catch_errors Whether to catch raised errors.
   # @return A Result or Results from the Futures
@@ -57,7 +57,7 @@ Puppet::Functions.create_function(:wait, Puppet::Functions::InternalFunction) do
   end
 
   # Wait for Futures to finish with timeout.
-  # @param futures A Bolt Future object or array of Bolt Futures to wait on.
+  # @param futures A Future object or array of Futures to wait on.
   # @param timeout How long to wait for Futures to finish before raising a Timeout error.
   # @param options A hash of additional options.
   # @option options [Boolean] _catch_errors Whether to catch raised errors.

data/bolt-modules/file/lib/puppet/functions/file/delete.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Delete a file on localhost using ruby's `File.delete`. This will only delete
-# files on the machine you run Bolt on.
+# files on the machine you run OpenBolt on.
 Puppet::Functions.create_function(:'file::delete') do
   # @param filename Absolute path.
   # @example Delete a file from disk

data/bolt-modules/file/lib/puppet/functions/file/exists.rb

@@ -2,7 +2,7 @@
 
 # Check if a local file exists using Puppet's
 # `Puppet::Parser::Files.find_file()` function. This will only check files that
-# are on the machine Bolt is run on.
+# are on the machine OpenBolt is run on.
 Puppet::Functions.create_function(:'file::exists', Puppet::Functions::InternalFunction) do
   # @param filename Absolute path or Puppet file path.
   # @return Whether the file exists.

data/bolt-modules/file/lib/puppet/functions/file/read.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Read a file on localhost and return its contents using ruby's `File.read`. This will
-# only read files on the machine you run Bolt on.
+# only read files on the machine you run OpenBolt on.
 Puppet::Functions.create_function(:'file::read', Puppet::Functions::InternalFunction) do
   # @param filename Absolute path or Puppet file path.
   # @return The file's contents.

data/bolt-modules/file/lib/puppet/functions/file/readable.rb

@@ -2,7 +2,7 @@
 
 # Check if a local file is readable using Puppet's
 # `Puppet::Parser::Files.find_file()` function. This will only check files on the
-# machine you run Bolt on.
+# machine you run OpenBolt on.
 Puppet::Functions.create_function(:'file::readable', Puppet::Functions::InternalFunction) do
   # @param filename Absolute path or Puppet file path.
   # @return Whether the file is readable.

data/bolt-modules/file/lib/puppet/functions/file/write.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Write a string to a file on localhost using ruby's `File.write`. This will
-# only write files to the machine you run Bolt on. Use `write_file()` to write
+# only write files to the machine you run OpenBolt on. Use `write_file()` to write
 # to remote targets.
 Puppet::Functions.create_function(:'file::write') do
   # @param filename Absolute path.

data/bolt-modules/log/lib/puppet/functions/log/debug.rb

@@ -8,7 +8,7 @@ require 'bolt/util/format'
 # what a plan is doing. For example, you might log a message at the `debug`
 # level that shows what value is returned from a function invocation.
 #
-# See [Logs](logs.md) for more information about Bolt's log levels.
+# See [Logs](logs.md) for more information about OpenBolt's log levels.
 #
 # > **Note:** Not available in apply block
 Puppet::Functions.create_function(:'log::debug') do

data/bolt-modules/log/lib/puppet/functions/log/error.rb

@@ -9,7 +9,7 @@ require 'bolt/util/format'
 # `error` level if you want to inform the user an action running on a target
 # failed but that the plan will continue running.
 #
-# See [Logs](logs.md) for more information about Bolt's log levels.
+# See [Logs](logs.md) for more information about OpenBolt's log levels.
 #
 # > **Note:** Not available in apply block
 Puppet::Functions.create_function(:'log::error') do

data/bolt-modules/log/lib/puppet/functions/log/fatal.rb

@@ -9,7 +9,7 @@ require 'bolt/util/format'
 # `fatal` level if a service is unavailable and the plan cannot continue running
 # without it.
 #
-# See [Logs](logs.md) for more information about Bolt's log levels.
+# See [Logs](logs.md) for more information about OpenBolt's log levels.
 #
 # > **Note:** Not available in apply block
 Puppet::Functions.create_function(:'log::fatal') do

data/bolt-modules/log/lib/puppet/functions/log/info.rb

@@ -8,7 +8,7 @@ require 'bolt/util/format'
 # what a plan is doing. For example, you might log a message at the `info` level
 # that informs users that the plan is reading a file on disk.
 #
-# See [Logs](logs.md) for more information about Bolt's log levels.
+# See [Logs](logs.md) for more information about OpenBolt's log levels.
 #
 # > **Note:** Not available in apply block
 Puppet::Functions.create_function(:'log::info') do

data/bolt-modules/log/lib/puppet/functions/log/trace.rb

@@ -8,7 +8,7 @@ require 'bolt/util/format'
 # about what a plan is doing. For example, you might log a message at the `trace`
 # level that describes how a plan is manipulating data.
 #
-# See [Logs](logs.md) for more information about Bolt's log levels.
+# See [Logs](logs.md) for more information about OpenBolt's log levels.
 #
 # > **Note:** Not available in apply block
 Puppet::Functions.create_function(:'log::trace') do

data/bolt-modules/log/lib/puppet/functions/log/warn.rb

@@ -10,7 +10,7 @@ require 'bolt/util/format'
 # planning to make a breaking change to your plan in a future release and
 # want to notify users.
 #
-# See [Logs](logs.md) for more information about Bolt's log levels.
+# See [Logs](logs.md) for more information about OpenBolt's log levels.
 #
 # > **Note:** Not available in apply block
 Puppet::Functions.create_function(:'log::warn') do

data/guides/targets.yaml

@@ -16,6 +16,8 @@ guide: |
 
     The 'targets' option accepts a comma-separated list of target URIs or group
     names, or can read a target list from an input file '@<file>' or stdin '-'.
+    The input can also be a JSON array of target names or a Bolt result object
+    with an 'items' array where each item has a 'target' key.
     URIs can be specified with the format [protocol://][user@]host[:port]. To
     learn more about available protocols and their defaults, run 'bolt guide
     transports'.