openvox 9.0.0.pre.alpha2 → 9.0.0.pre.beta2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +114 -1
- data/CODE_OF_CONDUCT.md +1 -1
- data/Gemfile +5 -5
- data/README.md +6 -6
- data/Rakefile +3 -3
- data/conf/environment.conf +2 -2
- data/conf/fileserver.conf +3 -3
- data/conf/puppet.conf +4 -4
- data/examples/enc/regexp_nodes/regexp_nodes.rb +2 -2
- data/examples/hiera/README.md +1 -1
- data/examples/nagios/check_puppet.rb +1 -1
- data/ext/README.md +3 -3
- data/ext/hiera/hiera.yaml +1 -1
- data/ext/project_data.yaml +1 -1
- data/ext/redhat/client.sysconfig +1 -0
- data/ext/solaris/smf/puppet.xml +2 -2
- data/ext/windows/puppet_interactive.bat +1 -1
- data/ext/windows/service/daemon.rb +5 -5
- data/lib/hiera/puppet_function.rb +1 -2
- data/lib/hiera_puppet.rb +1 -1
- data/lib/puppet/agent/disabler.rb +3 -3
- data/lib/puppet/agent/locker.rb +1 -1
- data/lib/puppet/agent.rb +2 -2
- data/lib/puppet/application/agent.rb +33 -35
- data/lib/puppet/application/apply.rb +7 -7
- data/lib/puppet/application/describe.rb +3 -3
- data/lib/puppet/application/device.rb +1 -1
- data/lib/puppet/application/doc.rb +5 -7
- data/lib/puppet/application/facts.rb +1 -1
- data/lib/puppet/application/filebucket.rb +5 -5
- data/lib/puppet/application/lookup.rb +8 -8
- data/lib/puppet/application/resource.rb +5 -5
- data/lib/puppet/application/script.rb +3 -3
- data/lib/puppet/application/ssl.rb +4 -4
- data/lib/puppet/application_support.rb +2 -2
- data/lib/puppet/configurer.rb +13 -7
- data/lib/puppet/confine/variable.rb +2 -2
- data/lib/puppet/context.rb +1 -1
- data/lib/puppet/data_binding.rb +1 -1
- data/lib/puppet/defaults.rb +157 -226
- data/lib/puppet/error.rb +1 -1
- data/lib/puppet/etc.rb +4 -4
- data/lib/puppet/face/catalog/select.rb +3 -3
- data/lib/puppet/face/catalog.rb +4 -4
- data/lib/puppet/face/config.rb +6 -6
- data/lib/puppet/face/facts.rb +6 -6
- data/lib/puppet/face/help/man.erb +3 -3
- data/lib/puppet/face/node/clean.rb +3 -3
- data/lib/puppet/face/node.rb +2 -2
- data/lib/puppet/face/plugin.rb +4 -4
- data/lib/puppet/functions/all.rb +4 -4
- data/lib/puppet/functions/any.rb +4 -4
- data/lib/puppet/functions/assert_type.rb +5 -5
- data/lib/puppet/functions/defined.rb +1 -1
- data/lib/puppet/functions/each.rb +11 -11
- data/lib/puppet/functions/epp.rb +5 -5
- data/lib/puppet/functions/eyaml_lookup_key.rb +1 -1
- data/lib/puppet/functions/filter.rb +5 -5
- data/lib/puppet/functions/find_file.rb +1 -1
- data/lib/puppet/functions/hiera.rb +4 -4
- data/lib/puppet/functions/hiera_array.rb +5 -5
- data/lib/puppet/functions/hiera_hash.rb +5 -5
- data/lib/puppet/functions/hiera_include.rb +6 -6
- data/lib/puppet/functions/hocon_data.rb +1 -1
- data/lib/puppet/functions/include.rb +1 -1
- data/lib/puppet/functions/index.rb +3 -3
- data/lib/puppet/functions/inline_epp.rb +6 -6
- data/lib/puppet/functions/json_data.rb +1 -1
- data/lib/puppet/functions/lest.rb +1 -1
- data/lib/puppet/functions/lookup.rb +14 -14
- data/lib/puppet/functions/map.rb +5 -5
- data/lib/puppet/functions/reduce.rb +6 -6
- data/lib/puppet/functions/regsubst.rb +1 -13
- data/lib/puppet/functions/reverse_each.rb +5 -5
- data/lib/puppet/functions/scanf.rb +1 -1
- data/lib/puppet/functions/step.rb +5 -5
- data/lib/puppet/functions/then.rb +1 -1
- data/lib/puppet/functions/tree_each.rb +3 -3
- data/lib/puppet/functions/versioncmp.rb +1 -1
- data/lib/puppet/functions/with.rb +2 -2
- data/lib/puppet/functions/yaml_data.rb +1 -1
- data/lib/puppet/generate/type.rb +5 -1
- data/lib/puppet/gettext/config.rb +5 -5
- data/lib/puppet/gettext/module_translations.rb +1 -1
- data/lib/puppet/graph/simple_graph.rb +0 -1
- data/lib/puppet/http/client.rb +5 -5
- data/lib/puppet/http/factory.rb +1 -1
- data/lib/puppet/http/resolver/server_list.rb +2 -2
- data/lib/puppet/http/service/compiler.rb +3 -3
- data/lib/puppet/http/service/file_server.rb +1 -1
- data/lib/puppet/http/service.rb +19 -1
- data/lib/puppet/http/session.rb +1 -1
- data/lib/puppet/http.rb +1 -1
- data/lib/puppet/indirector/catalog/compiler.rb +2 -2
- data/lib/puppet/indirector/data_binding/hiera.rb +93 -2
- data/lib/puppet/indirector/face.rb +4 -4
- data/lib/puppet/indirector/facts/facter.rb +7 -7
- data/lib/puppet/indirector/file_bucket_file/file.rb +2 -2
- data/lib/puppet/indirector/file_bucket_file/rest.rb +7 -3
- data/lib/puppet/indirector/file_content/file_server.rb +1 -1
- data/lib/puppet/indirector/file_metadata/file_server.rb +1 -1
- data/lib/puppet/indirector/node/exec.rb +1 -1
- data/lib/puppet/indirector/node/rest.rb +1 -1
- data/lib/puppet/indirector/report/processor.rb +1 -1
- data/lib/puppet/indirector.rb +1 -1
- data/lib/puppet/interface/documentation.rb +1 -1
- data/lib/puppet/interface/face_collection.rb +1 -1
- data/lib/puppet/interface/option.rb +2 -2
- data/lib/puppet/module/task.rb +1 -1
- data/lib/puppet/module_tool/applications/application.rb +1 -1
- data/lib/puppet/module_tool/metadata.rb +1 -2
- data/lib/puppet/module_tool.rb +1 -1
- data/lib/puppet/network/authorization.rb +1 -1
- data/lib/puppet/network/http/api.rb +2 -2
- data/lib/puppet/network/http/connection.rb +2 -2
- data/lib/puppet/node/environment.rb +6 -6
- data/lib/puppet/node.rb +2 -2
- data/lib/puppet/pal/catalog_compiler.rb +1 -1
- data/lib/puppet/pal/pal_impl.rb +1 -25
- data/lib/puppet/parser/compiler.rb +1 -1
- data/lib/puppet/parser/functions/assert_type.rb +5 -5
- data/lib/puppet/parser/functions/create_resources.rb +1 -1
- data/lib/puppet/parser/functions/defined.rb +1 -1
- data/lib/puppet/parser/functions/digest.rb +1 -1
- data/lib/puppet/parser/functions/each.rb +11 -11
- data/lib/puppet/parser/functions/epp.rb +5 -5
- data/lib/puppet/parser/functions/filter.rb +5 -5
- data/lib/puppet/parser/functions/generate.rb +1 -1
- data/lib/puppet/parser/functions/hiera.rb +3 -3
- data/lib/puppet/parser/functions/hiera_array.rb +4 -4
- data/lib/puppet/parser/functions/hiera_hash.rb +4 -4
- data/lib/puppet/parser/functions/hiera_include.rb +5 -5
- data/lib/puppet/parser/functions/include.rb +1 -1
- data/lib/puppet/parser/functions/inline_epp.rb +6 -6
- data/lib/puppet/parser/functions/inline_template.rb +1 -1
- data/lib/puppet/parser/functions/lest.rb +1 -1
- data/lib/puppet/parser/functions/lookup.rb +14 -14
- data/lib/puppet/parser/functions/map.rb +5 -5
- data/lib/puppet/parser/functions/reduce.rb +7 -7
- data/lib/puppet/parser/functions/reverse_each.rb +5 -5
- data/lib/puppet/parser/functions/scanf.rb +1 -1
- data/lib/puppet/parser/functions/step.rb +5 -5
- data/lib/puppet/parser/functions/then.rb +1 -1
- data/lib/puppet/parser/functions/versioncmp.rb +1 -1
- data/lib/puppet/parser/functions/with.rb +1 -1
- data/lib/puppet/parser/functions.rb +3 -3
- data/lib/puppet/parser/scope.rb +1 -1
- data/lib/puppet/plugins/syntax_checkers.rb +2 -2
- data/lib/puppet/plugins.rb +1 -1
- data/lib/puppet/pops/evaluator/collectors/exported_collector.rb +1 -1
- data/lib/puppet/pops/evaluator/deferred_resolver.rb +4 -1
- data/lib/puppet/pops/issues.rb +3 -3
- data/lib/puppet/pops/loader/module_loaders.rb +4 -4
- data/lib/puppet/pops/loader/ruby_legacy_function_instantiator.rb +1 -1
- data/lib/puppet/pops/loaders.rb +4 -4
- data/lib/puppet/pops/lookup/lookup_adapter.rb +7 -66
- data/lib/puppet/pops/model/factory.rb +5 -5
- data/lib/puppet/pops/resource/resource_type_impl.rb +1 -1
- data/lib/puppet/pops/serialization/to_data_converter.rb +1 -1
- data/lib/puppet/pops/types/iterable.rb +1 -1
- data/lib/puppet/property/keyvalue.rb +3 -3
- data/lib/puppet/provider/group/aix.rb +2 -2
- data/lib/puppet/provider/nameservice/directoryservice.rb +2 -2
- data/lib/puppet/provider/package/aix.rb +1 -1
- data/lib/puppet/provider/package/apt.rb +2 -2
- data/lib/puppet/provider/package/aptitude.rb +0 -1
- data/lib/puppet/provider/package/dnfmodule.rb +1 -1
- data/lib/puppet/provider/package/nim.rb +1 -1
- data/lib/puppet/provider/package/pacman.rb +1 -2
- data/lib/puppet/provider/package/pip.rb +1 -1
- data/lib/puppet/provider/package/pip2.rb +1 -1
- data/lib/puppet/provider/package/pip3.rb +1 -1
- data/lib/puppet/provider/package/pkgdmg.rb +2 -2
- data/lib/puppet/provider/package/puppet_gem.rb +2 -2
- data/lib/puppet/provider/package/puppetserver_gem.rb +1 -1
- data/lib/puppet/provider/package/windows.rb +1 -1
- data/lib/puppet/provider/service/freebsd.rb +1 -1
- data/lib/puppet/provider/service/init.rb +5 -5
- data/lib/puppet/provider/service/launchd.rb +2 -2
- data/lib/puppet/provider/service/smf.rb +1 -1
- data/lib/puppet/provider/service/upstart.rb +2 -2
- data/lib/puppet/provider/user/aix.rb +3 -3
- data/lib/puppet/provider/user/directoryservice.rb +9 -9
- data/lib/puppet/provider/user/pw.rb +3 -3
- data/lib/puppet/provider.rb +1 -1
- data/lib/puppet/reference/configuration.rb +6 -13
- data/lib/puppet/reference/function.rb +4 -4
- data/lib/puppet/reference/indirection.rb +2 -2
- data/lib/puppet/reference/metaparameter.rb +3 -3
- data/lib/puppet/reference/providers.rb +3 -3
- data/lib/puppet/reference/report.rb +4 -4
- data/lib/puppet/reference/type.rb +2 -2
- data/lib/puppet/relationship.rb +1 -1
- data/lib/puppet/reports/http.rb +4 -4
- data/lib/puppet/reports.rb +1 -1
- data/lib/puppet/resource/catalog.rb +4 -4
- data/lib/puppet/resource/type.rb +8 -8
- data/lib/puppet/settings/base_setting.rb +2 -3
- data/lib/puppet/settings/config_file.rb +3 -3
- data/lib/puppet/settings/environment_conf.rb +3 -11
- data/lib/puppet/settings.rb +11 -51
- data/lib/puppet/ssl/certificate.rb +4 -0
- data/lib/puppet/ssl/certificate_request.rb +1 -1
- data/lib/puppet/ssl/oids.rb +1 -1
- data/lib/puppet/ssl/openssl_loader.rb +1 -1
- data/lib/puppet/ssl/ssl_provider.rb +5 -5
- data/lib/puppet/ssl/state_machine.rb +9 -3
- data/lib/puppet/syntax_checkers.rb +1 -1
- data/lib/puppet/transaction/report.rb +3 -3
- data/lib/puppet/transaction.rb +0 -1
- data/lib/puppet/type/exec.rb +20 -20
- data/lib/puppet/type/file/content.rb +10 -37
- data/lib/puppet/type/file/ensure.rb +18 -9
- data/lib/puppet/type/file/mode.rb +4 -4
- data/lib/puppet/type/file/selcontext.rb +2 -2
- data/lib/puppet/type/file/source.rb +19 -25
- data/lib/puppet/type/file.rb +22 -15
- data/lib/puppet/type/filebucket.rb +22 -8
- data/lib/puppet/type/group.rb +5 -5
- data/lib/puppet/type/notify.rb +1 -1
- data/lib/puppet/type/package.rb +4 -4
- data/lib/puppet/type/schedule.rb +11 -11
- data/lib/puppet/type/service.rb +8 -8
- data/lib/puppet/type/stage.rb +1 -1
- data/lib/puppet/type/user.rb +19 -21
- data/lib/puppet/type/whit.rb +2 -2
- data/lib/puppet/type.rb +27 -27
- data/lib/puppet/util/character_encoding.rb +3 -3
- data/lib/puppet/util/command_line.rb +1 -1
- data/lib/puppet/util/execution.rb +1 -1
- data/lib/puppet/util/filetype.rb +6 -6
- data/lib/puppet/util/log.rb +2 -2
- data/lib/puppet/util/logging.rb +3 -3
- data/lib/puppet/util/plist.rb +1 -1
- data/lib/puppet/util/profiler/around_profiler.rb +1 -1
- data/lib/puppet/util/profiler.rb +1 -1
- data/lib/puppet/util/rdoc.rb +6 -3
- data/lib/puppet/util/selinux.rb +5 -5
- data/lib/puppet/util/tag_set.rb +0 -1
- data/lib/puppet/util/windows/adsi.rb +1 -1
- data/lib/puppet/util/windows/com.rb +2 -2
- data/lib/puppet/util/windows/eventlog.rb +6 -6
- data/lib/puppet/util/windows/file.rb +2 -2
- data/lib/puppet/util/windows/security.rb +3 -3
- data/lib/puppet/util.rb +8 -3
- data/lib/puppet/version.rb +8 -8
- data/lib/puppet/x509/cert_provider.rb +1 -1
- data/lib/puppet.rb +5 -5
- data/locales/config.yaml +3 -3
- data/locales/puppet.pot +462 -464
- data/man/man5/puppet.conf.5 +122 -146
- data/man/man8/puppet-agent.8 +25 -25
- data/man/man8/puppet-apply.8 +6 -6
- data/man/man8/puppet-catalog.8 +11 -11
- data/man/man8/puppet-config.8 +7 -7
- data/man/man8/puppet-describe.8 +3 -3
- data/man/man8/puppet-device.8 +2 -2
- data/man/man8/puppet-doc.8 +5 -5
- data/man/man8/puppet-epp.8 +3 -3
- data/man/man8/puppet-facts.8 +11 -11
- data/man/man8/puppet-filebucket.8 +5 -5
- data/man/man8/puppet-generate.8 +3 -3
- data/man/man8/puppet-help.8 +3 -3
- data/man/man8/puppet-lookup.8 +8 -8
- data/man/man8/puppet-module.8 +7 -7
- data/man/man8/puppet-node.8 +11 -45
- data/man/man8/puppet-parser.8 +3 -3
- data/man/man8/puppet-plugin.8 +7 -7
- data/man/man8/puppet-report.8 +6 -6
- data/man/man8/puppet-resource.8 +5 -5
- data/man/man8/puppet-script.8 +3 -3
- data/man/man8/puppet-ssl.8 +21 -23
- data/man/man8/puppet.8 +2 -2
- metadata +5 -8
- data/lib/puppet/indirector/hiera.rb +0 -101
- data/lib/puppet/util/rdoc/generators/puppet_generator.rb +0 -902
- data/lib/puppet/util/rdoc/generators/template/puppet/puppet.rb +0 -1068
data/lib/puppet/error.rb
CHANGED
data/lib/puppet/etc.rb
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
require_relative '../puppet/util/character_encoding'
|
|
4
4
|
# Wrapper around Ruby Etc module allowing us to manage encoding in a single
|
|
5
5
|
# place.
|
|
6
|
-
# This represents a subset of Ruby's Etc module, only the methods required by
|
|
6
|
+
# This represents a subset of Ruby's Etc module, only the methods required by OpenVox.
|
|
7
7
|
|
|
8
8
|
# On Ruby 2.1.0 and later, Etc returns strings in variable encoding depending on
|
|
9
9
|
# environment. The string returned will be labeled with the environment's
|
|
@@ -21,11 +21,11 @@ require_relative '../puppet/util/character_encoding'
|
|
|
21
21
|
# On Ruby 2.0.x and earlier, Etc will always return string values in BINARY,
|
|
22
22
|
# ignoring encoding altogether.
|
|
23
23
|
#
|
|
24
|
-
# For
|
|
24
|
+
# For OpenVox we specifically want UTF-8 as our input from the Etc module - which
|
|
25
25
|
# is our input for many resource instance 'is' values. The associated 'should'
|
|
26
|
-
# value will basically always be coming from
|
|
26
|
+
# value will basically always be coming from OpenVox in UTF-8 - and written to
|
|
27
27
|
# disk as UTF-8. Etc is defined for Windows but the majority calls to it return
|
|
28
|
-
# nil and
|
|
28
|
+
# nil and OpenVox does not use it.
|
|
29
29
|
#
|
|
30
30
|
# That being said, we have cause to retain the original, pre-override string
|
|
31
31
|
# values. `puppet resource user`
|
|
@@ -14,15 +14,15 @@ Puppet::Face.define(:catalog, '0.0.1') do
|
|
|
14
14
|
resources of the requested type.
|
|
15
15
|
EOT
|
|
16
16
|
notes <<-'NOTES'
|
|
17
|
-
By default, this action will retrieve a catalog from
|
|
17
|
+
By default, this action will retrieve a catalog from OpenVox's compiler
|
|
18
18
|
subsystem; you must call the action with `--terminus rest` if you wish
|
|
19
|
-
to retrieve a catalog from the
|
|
19
|
+
to retrieve a catalog from the OpenVox server.
|
|
20
20
|
|
|
21
21
|
FORMATTING ISSUES: This action cannot currently render useful yaml;
|
|
22
22
|
instead, it returns an entire catalog. Use json instead.
|
|
23
23
|
NOTES
|
|
24
24
|
examples <<-'EOT'
|
|
25
|
-
Ask the
|
|
25
|
+
Ask the OpenVox server for a list of managed file resources for a node:
|
|
26
26
|
|
|
27
27
|
$ puppet catalog select --terminus rest somenode.magpie.lan file
|
|
28
28
|
EOT
|
data/lib/puppet/face/catalog.rb
CHANGED
|
@@ -62,7 +62,7 @@ Puppet::Indirector::Face.define(:catalog, '0.0.1') do
|
|
|
62
62
|
|
|
63
63
|
$ puppet catalog apply --terminus yaml
|
|
64
64
|
|
|
65
|
-
Retrieve a catalog from the
|
|
65
|
+
Retrieve a catalog from the server and apply it, in one step:
|
|
66
66
|
|
|
67
67
|
$ puppet catalog apply --terminus rest
|
|
68
68
|
|
|
@@ -119,10 +119,10 @@ Puppet::Indirector::Face.define(:catalog, '0.0.1') do
|
|
|
119
119
|
end
|
|
120
120
|
|
|
121
121
|
action(:download) do
|
|
122
|
-
summary "Download this node's catalog from the
|
|
122
|
+
summary "Download this node's catalog from the OpenVox server."
|
|
123
123
|
description <<-'EOT'
|
|
124
|
-
Retrieves a catalog from the
|
|
125
|
-
cache. This action always contacts the
|
|
124
|
+
Retrieves a catalog from the OpenVox server and saves it to the local yaml
|
|
125
|
+
cache. This action always contacts the OpenVox server and will ignore
|
|
126
126
|
alternate termini.
|
|
127
127
|
|
|
128
128
|
The saved catalog can be used in any subsequent catalog action by specifying
|
data/lib/puppet/face/config.rb
CHANGED
|
@@ -12,7 +12,7 @@ Puppet::Face.define(:config, '0.0.1') do
|
|
|
12
12
|
|
|
13
13
|
description "This subcommand can inspect and modify settings from OpenVox's
|
|
14
14
|
'puppet.conf' configuration file. For documentation about individual settings,
|
|
15
|
-
see https://
|
|
15
|
+
see https://docs.openvoxproject.org/openvox/latest/configuration.html."
|
|
16
16
|
|
|
17
17
|
DEFAULT_SECTION_MARKER = Object.new
|
|
18
18
|
DEFAULT_SECTION = "main"
|
|
@@ -25,7 +25,7 @@ Puppet::Face.define(:config, '0.0.1') do
|
|
|
25
25
|
The three most commonly used sections are 'main', 'server', and 'agent'.
|
|
26
26
|
'Main' is the default, and is used by all OpenVox applications. Other
|
|
27
27
|
sections can override 'main' values for specific applications --- the
|
|
28
|
-
'server' section affects
|
|
28
|
+
'server' section affects OpenVox Server, and the 'agent'
|
|
29
29
|
section affects puppet agent.
|
|
30
30
|
|
|
31
31
|
Less commonly used is the 'user' section, which affects puppet apply. Any
|
|
@@ -50,7 +50,7 @@ Puppet::Face.define(:config, '0.0.1') do
|
|
|
50
50
|
configuration domains.
|
|
51
51
|
EOT
|
|
52
52
|
examples <<-'EOT'
|
|
53
|
-
Get
|
|
53
|
+
Get OpenVox's runfile directory:
|
|
54
54
|
|
|
55
55
|
$ puppet config print rundir
|
|
56
56
|
|
|
@@ -104,7 +104,7 @@ Puppet::Face.define(:config, '0.0.1') do
|
|
|
104
104
|
messages << _("Set the config section by using the `--section` flag.")
|
|
105
105
|
# TRANSLATORS `puppet config --section user print foo` is a command line example and should not be translated
|
|
106
106
|
messages << _("For example, `puppet config --section user print foo`.")
|
|
107
|
-
messages << _("For more information, see https://
|
|
107
|
+
messages << _("For more information, see https://docs.openvoxproject.org/openvox/latest/configuration.html")
|
|
108
108
|
|
|
109
109
|
Puppet.warning(messages.join("\n"))
|
|
110
110
|
end
|
|
@@ -127,7 +127,7 @@ Puppet::Face.define(:config, '0.0.1') do
|
|
|
127
127
|
configuration domains.
|
|
128
128
|
EOT
|
|
129
129
|
examples <<-'EOT'
|
|
130
|
-
Set
|
|
130
|
+
Set OpenVox's runfile directory:
|
|
131
131
|
|
|
132
132
|
$ puppet config set rundir /var/run/puppetlabs
|
|
133
133
|
|
|
@@ -152,7 +152,7 @@ Puppet::Face.define(:config, '0.0.1') do
|
|
|
152
152
|
require the defined environment directory to exist locally. Set the config
|
|
153
153
|
section by using the `--section` flag. For example,
|
|
154
154
|
`puppet config --section user set environment foo`. For more information, see
|
|
155
|
-
https://
|
|
155
|
+
https://docs.openvoxproject.org/openvox/latest/configuration.html#environment
|
|
156
156
|
EOM
|
|
157
157
|
end
|
|
158
158
|
|
data/lib/puppet/face/facts.rb
CHANGED
|
@@ -38,19 +38,19 @@ Puppet::Indirector::Face.define(:facts, '0.0.1') do
|
|
|
38
38
|
deactivate_action(:search)
|
|
39
39
|
|
|
40
40
|
action(:upload) do
|
|
41
|
-
summary _("Upload local facts to the
|
|
41
|
+
summary _("Upload local facts to the OpenVox server.")
|
|
42
42
|
description <<-'EOT'
|
|
43
43
|
Reads facts from the local system using the `facter` terminus, then
|
|
44
44
|
saves the returned facts using the rest terminus.
|
|
45
45
|
EOT
|
|
46
46
|
returns "Nothing."
|
|
47
47
|
notes <<-'EOT'
|
|
48
|
-
This action requires that the
|
|
48
|
+
This action requires that the OpenVox Server's `auth.conf` file
|
|
49
49
|
allow `PUT` or `save` access to the `/puppet/v3/facts` API endpoint.
|
|
50
50
|
|
|
51
|
-
For details on configuring
|
|
51
|
+
For details on configuring OpenVox Server's `auth.conf`, see:
|
|
52
52
|
|
|
53
|
-
<https://
|
|
53
|
+
<https://docs.openvoxproject.org/openvox-server/latest/config_file_auth.html>
|
|
54
54
|
EOT
|
|
55
55
|
examples <<-'EOT'
|
|
56
56
|
Upload facts:
|
|
@@ -61,7 +61,7 @@ Puppet::Indirector::Face.define(:facts, '0.0.1') do
|
|
|
61
61
|
render_as :json
|
|
62
62
|
|
|
63
63
|
when_invoked do |_options|
|
|
64
|
-
# Use `agent` sections settings for certificates,
|
|
64
|
+
# Use `agent` sections settings for certificates, OpenVox Server URL,
|
|
65
65
|
# etc. instead of `user` section settings.
|
|
66
66
|
Puppet.settings.preferred_run_mode = :agent
|
|
67
67
|
Puppet::Node::Facts.indirection.terminus_class = :facter
|
|
@@ -106,7 +106,7 @@ Puppet::Indirector::Face.define(:facts, '0.0.1') do
|
|
|
106
106
|
|
|
107
107
|
option("--config-file " + _("<path>")) do
|
|
108
108
|
default_to { nil }
|
|
109
|
-
summary _("The location of the config file for
|
|
109
|
+
summary _("The location of the config file for OpenFact.")
|
|
110
110
|
end
|
|
111
111
|
|
|
112
112
|
option("--custom-dir " + _("<path>")) do
|
|
@@ -23,7 +23,7 @@ settings, so you can specify `--server <servername>`, or
|
|
|
23
23
|
`--run_mode <runmode>` as an argument.
|
|
24
24
|
|
|
25
25
|
See the configuration file documentation at
|
|
26
|
-
<https://
|
|
26
|
+
<https://docs.openvoxproject.org/openvox/latest/configuration.html> for the
|
|
27
27
|
full list of acceptable parameters. A commented list of all
|
|
28
28
|
configuration options can also be generated by running puppet with
|
|
29
29
|
`--genconfig`.
|
|
@@ -133,7 +133,7 @@ NOTES
|
|
|
133
133
|
<% end # notes
|
|
134
134
|
if face.respond_to? :indirection -%>
|
|
135
135
|
This subcommand is an indirector face, which exposes `find`, `search`, `save`,
|
|
136
|
-
and `destroy` actions for an indirected subsystem of
|
|
136
|
+
and `destroy` actions for an indirected subsystem of OpenVox. Valid termini for
|
|
137
137
|
this face include:
|
|
138
138
|
|
|
139
139
|
* `<%= face.class.terminus_classes(face.indirection.name).join("`\n* `") %>`
|
|
@@ -148,5 +148,5 @@ AUTHOR
|
|
|
148
148
|
<% end -%>
|
|
149
149
|
COPYRIGHT AND LICENSE
|
|
150
150
|
---------------------
|
|
151
|
-
<%= face.copyright
|
|
151
|
+
<%= face.copyright %>.
|
|
152
152
|
<%= face.license %>
|
|
@@ -2,10 +2,10 @@
|
|
|
2
2
|
|
|
3
3
|
Puppet::Face.define(:node, '0.0.1') do
|
|
4
4
|
action(:clean) do
|
|
5
|
-
summary _("Clean up signed certs, cached facts, node objects, and reports for a node stored by the
|
|
5
|
+
summary _("Clean up signed certs, cached facts, node objects, and reports for a node stored by the OpenVox server")
|
|
6
6
|
arguments _("<host1> [<host2> ...]")
|
|
7
7
|
description <<-'EOT'
|
|
8
|
-
Cleans up the following information
|
|
8
|
+
Cleans up the following information an OpenVox server knows about a node:
|
|
9
9
|
|
|
10
10
|
<Signed certificates> - ($vardir/ssl/ca/signed/node.domain.pem)
|
|
11
11
|
|
|
@@ -15,7 +15,7 @@ Puppet::Face.define(:node, '0.0.1') do
|
|
|
15
15
|
|
|
16
16
|
<Reports> - ($vardir/reports/node.domain)
|
|
17
17
|
|
|
18
|
-
NOTE: this action now cleans up certs via
|
|
18
|
+
NOTE: this action now cleans up certs via OpenVox Server's CA API. A running server is required for certs to be cleaned.
|
|
19
19
|
EOT
|
|
20
20
|
|
|
21
21
|
when_invoked do |*args|
|
data/lib/puppet/face/node.rb
CHANGED
|
@@ -34,11 +34,11 @@ Puppet::Indirector::Face.define(:node, '0.0.1') do
|
|
|
34
34
|
|
|
35
35
|
$ puppet node find somenode.puppetlabs.lan --terminus plain --render-as yaml
|
|
36
36
|
|
|
37
|
-
Retrieve a node using the
|
|
37
|
+
Retrieve a node using the OpenVox Server's configured ENC:
|
|
38
38
|
|
|
39
39
|
$ puppet node find somenode.puppetlabs.lan --terminus exec --run_mode server --render-as yaml
|
|
40
40
|
|
|
41
|
-
Retrieve the same node from the
|
|
41
|
+
Retrieve the same node from the OpenVox Server:
|
|
42
42
|
|
|
43
43
|
$ puppet node find somenode.puppetlabs.lan --terminus rest --render-as yaml
|
|
44
44
|
EOT
|
data/lib/puppet/face/plugin.rb
CHANGED
|
@@ -14,12 +14,12 @@ Puppet::Face.define(:plugin, '0.0.1') do
|
|
|
14
14
|
|
|
15
15
|
The OpenVox server serves Ruby code collected from the `lib` directories
|
|
16
16
|
of its modules. These plugins can be used on agent nodes to extend
|
|
17
|
-
|
|
17
|
+
OpenFact and implement custom types and providers. Plugins are normally
|
|
18
18
|
downloaded by the OpenVox agent during the course of a run.
|
|
19
19
|
EOT
|
|
20
20
|
|
|
21
21
|
action :download do
|
|
22
|
-
summary _("Download plugins from the
|
|
22
|
+
summary _("Download plugins from the OpenVox server.")
|
|
23
23
|
description <<-'EOT'
|
|
24
24
|
Downloads plugins from the configured OpenVox server. Any plugins
|
|
25
25
|
downloaded in this way will be used in all subsequent OpenVox activity.
|
|
@@ -31,11 +31,11 @@ Puppet::Face.define(:plugin, '0.0.1') do
|
|
|
31
31
|
the files downloaded, which will be empty if none were retrieved.
|
|
32
32
|
EOT
|
|
33
33
|
examples <<-'EOT'
|
|
34
|
-
Retrieve plugins from the
|
|
34
|
+
Retrieve plugins from the OpenVox server:
|
|
35
35
|
|
|
36
36
|
$ puppet plugin download
|
|
37
37
|
|
|
38
|
-
Retrieve plugins from the
|
|
38
|
+
Retrieve plugins from the OpenVox server (API example):
|
|
39
39
|
|
|
40
40
|
$ Puppet::Face[:plugin, '0.0.1'].download
|
|
41
41
|
EOT
|
data/lib/puppet/functions/all.rb
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# frozen_string_literal: true
|
|
2
2
|
|
|
3
|
-
# Runs a [lambda](https://
|
|
3
|
+
# Runs a [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html)
|
|
4
4
|
# repeatedly using each value in a data structure until the lambda returns a non "truthy" value which
|
|
5
5
|
# makes the function return `false`, or if the end of the iteration is reached, `true` is returned.
|
|
6
6
|
#
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
#
|
|
29
29
|
# Would notice `true`.
|
|
30
30
|
#
|
|
31
|
-
# When the first argument is a `Hash`,
|
|
31
|
+
# When the first argument is a `Hash`, OpenVox passes each key and value pair to the lambda
|
|
32
32
|
# as an array in the form `[key, value]`.
|
|
33
33
|
#
|
|
34
34
|
# @example Using the `all` function with a `Hash` and a one-parameter lambda
|
|
@@ -55,8 +55,8 @@
|
|
|
55
55
|
#
|
|
56
56
|
# Would notice `true`.
|
|
57
57
|
#
|
|
58
|
-
# For an general examples that demonstrates iteration, see the
|
|
59
|
-
# [iteration](https://
|
|
58
|
+
# For an general examples that demonstrates iteration, see the OpenVox
|
|
59
|
+
# [iteration](https://docs.openvoxproject.org/openvox/latest/lang_iteration.html)
|
|
60
60
|
# documentation.
|
|
61
61
|
#
|
|
62
62
|
# @since 5.2.0
|
data/lib/puppet/functions/any.rb
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# frozen_string_literal: true
|
|
2
2
|
|
|
3
|
-
# Runs a [lambda](https://
|
|
3
|
+
# Runs a [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html)
|
|
4
4
|
# repeatedly using each value in a data structure until the lambda returns a "truthy" value which
|
|
5
5
|
# makes the function return `true`, or if the end of the iteration is reached, false is returned.
|
|
6
6
|
#
|
|
@@ -31,7 +31,7 @@
|
|
|
31
31
|
# one of the keys. That is, it is equivalent to the expression
|
|
32
32
|
# `$looked_up[routers] || $looked_up[servers] || $looked_up[workstations]`.
|
|
33
33
|
#
|
|
34
|
-
# When the first argument is a `Hash`,
|
|
34
|
+
# When the first argument is a `Hash`, OpenVox passes each key and value pair to the lambda
|
|
35
35
|
# as an array in the form `[key, value]`.
|
|
36
36
|
#
|
|
37
37
|
# @example Using the `any` function with a `Hash` and a one-parameter lambda
|
|
@@ -60,8 +60,8 @@
|
|
|
60
60
|
#
|
|
61
61
|
# Would notice true as the index `2` is even and not a `String`
|
|
62
62
|
#
|
|
63
|
-
# For an general examples that demonstrates iteration, see the
|
|
64
|
-
# [iteration](https://
|
|
63
|
+
# For an general examples that demonstrates iteration, see the OpenVox
|
|
64
|
+
# [iteration](https://docs.openvoxproject.org/openvox/latest/lang_iteration.html)
|
|
65
65
|
# documentation.
|
|
66
66
|
#
|
|
67
67
|
# @since 5.2.0
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# frozen_string_literal: true
|
|
2
2
|
|
|
3
3
|
# Returns the given value if it is of the given
|
|
4
|
-
# [data type](https://
|
|
4
|
+
# [data type](https://docs.openvoxproject.org/openvox/latest/lang_data.html), or
|
|
5
5
|
# otherwise either raises an error or executes an optional two-parameter
|
|
6
|
-
# [lambda](https://
|
|
6
|
+
# [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html).
|
|
7
7
|
#
|
|
8
8
|
# The function takes two mandatory arguments, in this order:
|
|
9
9
|
#
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
# $valid_username = assert_type(String[1], $raw_username)
|
|
20
20
|
#
|
|
21
21
|
# # $valid_username contains "Amy Berry".
|
|
22
|
-
# # If $raw_username was an empty string or a different data type, the
|
|
22
|
+
# # If $raw_username was an empty string or a different data type, the OpenVox run would
|
|
23
23
|
# # fail with an "Expected type does not match actual" error.
|
|
24
24
|
# ```
|
|
25
25
|
#
|
|
@@ -42,13 +42,13 @@
|
|
|
42
42
|
# }
|
|
43
43
|
#
|
|
44
44
|
# # $valid_username contains "Amy Berry".
|
|
45
|
-
# # If $raw_username was an empty string, the
|
|
45
|
+
# # If $raw_username was an empty string, the OpenVox run would set $valid_username to
|
|
46
46
|
# # "anonymous" and output a warning: "The username should be 'String[1, default]', not
|
|
47
47
|
# # 'String[0, 0]'. Using 'anonymous'."
|
|
48
48
|
# ```
|
|
49
49
|
#
|
|
50
50
|
# For more information about data types, see the
|
|
51
|
-
# [documentation](https://
|
|
51
|
+
# [documentation](https://docs.openvoxproject.org/openvox/latest/lang_data.html).
|
|
52
52
|
#
|
|
53
53
|
# @since 4.0.0
|
|
54
54
|
#
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
# defined(File['/tmp/file'])
|
|
33
33
|
# ```
|
|
34
34
|
#
|
|
35
|
-
#
|
|
35
|
+
# OpenVox depends on the configuration's evaluation order when checking whether a resource
|
|
36
36
|
# is declared.
|
|
37
37
|
#
|
|
38
38
|
# @example Importance of evaluation order when using `defined`
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# frozen_string_literal: true
|
|
2
2
|
|
|
3
|
-
# Runs a [lambda](https://
|
|
3
|
+
# Runs a [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html)
|
|
4
4
|
# repeatedly using each value in a data structure, then returns the values unchanged.
|
|
5
5
|
#
|
|
6
6
|
# This function takes two mandatory arguments, in this order:
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
#
|
|
18
18
|
# `each($data) |$parameter| { <PUPPET CODE BLOCK> }`
|
|
19
19
|
#
|
|
20
|
-
# When the first argument (`$data` in the above example) is an array,
|
|
20
|
+
# When the first argument (`$data` in the above example) is an array, OpenVox passes each
|
|
21
21
|
# value in turn to the lambda, then returns the original values.
|
|
22
22
|
#
|
|
23
23
|
# @example Using the `each` function with an array and a one-parameter lambda
|
|
@@ -30,11 +30,11 @@
|
|
|
30
30
|
# message => $item
|
|
31
31
|
# }
|
|
32
32
|
# }
|
|
33
|
-
# #
|
|
33
|
+
# # OpenVox creates one resource for each of the three items in $data. Each resource is
|
|
34
34
|
# # named after the item's value and uses the item's value in a parameter.
|
|
35
35
|
# ```
|
|
36
36
|
#
|
|
37
|
-
# When the first argument is a hash,
|
|
37
|
+
# When the first argument is a hash, OpenVox passes each key and value pair to the lambda
|
|
38
38
|
# as an array in the form `[key, value]` and returns the original hash.
|
|
39
39
|
#
|
|
40
40
|
# @example Using the `each` function with a hash and a one-parameter lambda
|
|
@@ -48,11 +48,11 @@
|
|
|
48
48
|
# message => $items[1]
|
|
49
49
|
# }
|
|
50
50
|
# }
|
|
51
|
-
# #
|
|
51
|
+
# # OpenVox creates one resource for each of the three items in $data, each named after the
|
|
52
52
|
# # item's key and containing a parameter using the item's value.
|
|
53
53
|
# ```
|
|
54
54
|
#
|
|
55
|
-
# When the first argument is an array and the lambda has two parameters,
|
|
55
|
+
# When the first argument is an array and the lambda has two parameters, OpenVox passes the
|
|
56
56
|
# array's indexes (enumerated from 0) in the first parameter and its values in the second
|
|
57
57
|
# parameter.
|
|
58
58
|
#
|
|
@@ -67,11 +67,11 @@
|
|
|
67
67
|
# message => $index
|
|
68
68
|
# }
|
|
69
69
|
# }
|
|
70
|
-
# #
|
|
70
|
+
# # OpenVox creates one resource for each of the three items in $data, each named after the
|
|
71
71
|
# # item's value and containing a parameter using the item's index.
|
|
72
72
|
# ```
|
|
73
73
|
#
|
|
74
|
-
# When the first argument is a hash,
|
|
74
|
+
# When the first argument is a hash, OpenVox passes its keys to the first parameter and its
|
|
75
75
|
# values to the second parameter.
|
|
76
76
|
#
|
|
77
77
|
# @example Using the `each` function with a hash and a two-parameter lambda
|
|
@@ -85,13 +85,13 @@
|
|
|
85
85
|
# message => $value
|
|
86
86
|
# }
|
|
87
87
|
# }
|
|
88
|
-
# #
|
|
88
|
+
# # OpenVox creates one resource for each of the three items in $data, each named after the
|
|
89
89
|
# # item's key and containing a parameter using the item's value.
|
|
90
90
|
# ```
|
|
91
91
|
#
|
|
92
92
|
# For an example that demonstrates how to create multiple `file` resources using `each`,
|
|
93
|
-
# see the
|
|
94
|
-
# [iteration](https://
|
|
93
|
+
# see the OpenVox
|
|
94
|
+
# [iteration](https://docs.openvoxproject.org/openvox/latest/lang_iteration.html)
|
|
95
95
|
# documentation.
|
|
96
96
|
#
|
|
97
97
|
# @since 4.0.0
|
data/lib/puppet/functions/epp.rb
CHANGED
|
@@ -8,12 +8,12 @@
|
|
|
8
8
|
# The first argument to this function should be a `<MODULE NAME>/<TEMPLATE FILE>`
|
|
9
9
|
# reference, which loads `<TEMPLATE FILE>` from `<MODULE NAME>`'s `templates`
|
|
10
10
|
# directory. In most cases, the last argument is optional; if used, it should be a
|
|
11
|
-
# [hash](https://
|
|
11
|
+
# [hash](https://docs.openvoxproject.org/openvox/latest/lang_data_hash.html) that contains parameters to
|
|
12
12
|
# pass to the template.
|
|
13
13
|
#
|
|
14
|
-
# - See the [template](https://
|
|
14
|
+
# - See the [template](https://docs.openvoxproject.org/openvox/latest/lang_template.html)
|
|
15
15
|
# documentation for general template usage information.
|
|
16
|
-
# - See the [EPP syntax](https://
|
|
16
|
+
# - See the [EPP syntax](https://docs.openvoxproject.org/openvox/latest/lang_template_epp.html)
|
|
17
17
|
# documentation for examples of EPP.
|
|
18
18
|
#
|
|
19
19
|
# For example, to call the apache module's `templates/vhost/_docroot.epp`
|
|
@@ -26,12 +26,12 @@
|
|
|
26
26
|
# This function can also accept an absolute path, which can load a template file
|
|
27
27
|
# from anywhere on disk.
|
|
28
28
|
#
|
|
29
|
-
#
|
|
29
|
+
# OpenVox produces a syntax error if you pass more parameters than are declared in
|
|
30
30
|
# the template's parameter tag. When passing parameters to a template that
|
|
31
31
|
# contains a parameter tag, use the same names as the tag's declared parameters.
|
|
32
32
|
#
|
|
33
33
|
# Parameters are required only if they are declared in the called template's
|
|
34
|
-
# parameter tag without default values.
|
|
34
|
+
# parameter tag without default values. OpenVox produces an error if the `epp`
|
|
35
35
|
# function fails to pass any required parameter.
|
|
36
36
|
#
|
|
37
37
|
# @since 4.0.0
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# frozen_string_literal: true
|
|
2
2
|
|
|
3
3
|
# The `eyaml_lookup_key` is a hiera 5 `lookup_key` data provider function.
|
|
4
|
-
# See [the configuration guide documentation](https://
|
|
4
|
+
# See [the configuration guide documentation](https://docs.openvoxproject.org/openvox/latest/hiera_config_yaml_5.html#configuring-a-hierarchy-level-hiera-eyaml) for
|
|
5
5
|
# how to use this function.
|
|
6
6
|
#
|
|
7
7
|
# @since 5.0.0
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# frozen_string_literal: true
|
|
2
2
|
|
|
3
|
-
# Applies a [lambda](https://
|
|
3
|
+
# Applies a [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html)
|
|
4
4
|
# to every value in a data structure and returns an array or hash containing any elements
|
|
5
5
|
# for which the lambda evaluates to a truthy value (not `false` or `undef`).
|
|
6
6
|
#
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
#
|
|
19
19
|
# `$filtered_data = filter($data) |$parameter| { <PUPPET CODE BLOCK> }`
|
|
20
20
|
#
|
|
21
|
-
# When the first argument (`$data` in the above example) is an array,
|
|
21
|
+
# When the first argument (`$data` in the above example) is an array, OpenVox passes each
|
|
22
22
|
# value in turn to the lambda and returns an array containing the results.
|
|
23
23
|
#
|
|
24
24
|
# @example Using the `filter` function with an array and a one-parameter lambda
|
|
@@ -30,7 +30,7 @@
|
|
|
30
30
|
# # $filtered_data = [blueberry, raspberry]
|
|
31
31
|
# ```
|
|
32
32
|
#
|
|
33
|
-
# When the first argument is a hash,
|
|
33
|
+
# When the first argument is a hash, OpenVox passes each key and value pair to the lambda
|
|
34
34
|
# as an array in the form `[key, value]` and returns a hash containing the results.
|
|
35
35
|
#
|
|
36
36
|
# @example Using the `filter` function with a hash and a one-parameter lambda
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
# # $filtered_data = {blueberry => 1, raspberry => 2}
|
|
43
43
|
# ```
|
|
44
44
|
#
|
|
45
|
-
# When the first argument is an array and the lambda has two parameters,
|
|
45
|
+
# When the first argument is an array and the lambda has two parameters, OpenVox passes the
|
|
46
46
|
# array's indexes (enumerated from 0) in the first parameter and its values in the second
|
|
47
47
|
# parameter.
|
|
48
48
|
#
|
|
@@ -56,7 +56,7 @@
|
|
|
56
56
|
# # $filtered_data = [raspberry]
|
|
57
57
|
# ```
|
|
58
58
|
#
|
|
59
|
-
# When the first argument is a hash,
|
|
59
|
+
# When the first argument is a hash, OpenVox passes its keys to the first parameter and its
|
|
60
60
|
# values to the second parameter.
|
|
61
61
|
#
|
|
62
62
|
# @example Using the `filter` function with a hash and a two-parameter lambda
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
# file `<MODULES DIRECTORY>/mysql/files/mysqltuner.pl`.)
|
|
9
9
|
#
|
|
10
10
|
# If this function is run via puppet agent, it checks for file existence on the
|
|
11
|
-
#
|
|
11
|
+
# OpenVox server. If run via puppet apply, it checks on the local host.
|
|
12
12
|
# In both cases, the check is performed before any resources are changed.
|
|
13
13
|
#
|
|
14
14
|
# This function can also accept:
|
|
@@ -14,7 +14,7 @@ require 'hiera/puppet_function'
|
|
|
14
14
|
#
|
|
15
15
|
# 1. A string key that Hiera searches for in the hierarchy. **Required**.
|
|
16
16
|
# 2. An optional default value to return if Hiera doesn't find anything matching the key.
|
|
17
|
-
# * If this argument isn't provided and this function results in a lookup failure,
|
|
17
|
+
# * If this argument isn't provided and this function results in a lookup failure, OpenVox
|
|
18
18
|
# fails with a compilation error.
|
|
19
19
|
# 3. The optional name of an arbitrary
|
|
20
20
|
# [hierarchy level](https://puppet.com/docs/hiera/latest/hierarchy.html) to insert at the
|
|
@@ -59,7 +59,7 @@ require 'hiera/puppet_function'
|
|
|
59
59
|
# ```
|
|
60
60
|
#
|
|
61
61
|
# You can optionally generate the default value with a
|
|
62
|
-
# [lambda](https://
|
|
62
|
+
# [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html) that
|
|
63
63
|
# takes one parameter.
|
|
64
64
|
#
|
|
65
65
|
# @example Using `hiera` with a lambda
|
|
@@ -79,9 +79,9 @@ require 'hiera/puppet_function'
|
|
|
79
79
|
# above, Hiera matches the 'users' key and returns it as a hash.
|
|
80
80
|
#
|
|
81
81
|
# See
|
|
82
|
-
# [the 'Using the lookup function' documentation](https://
|
|
82
|
+
# [the 'Using the lookup function' documentation](https://docs.openvoxproject.org/openvox/latest/hiera_automatic.html) for how to perform lookup of data.
|
|
83
83
|
# Also see
|
|
84
|
-
# [the 'Using the deprecated hiera functions' documentation](https://
|
|
84
|
+
# [the 'Using the deprecated hiera functions' documentation](https://docs.openvoxproject.org/openvox/latest/hiera_automatic.html)
|
|
85
85
|
# for more information about the Hiera 3 functions.
|
|
86
86
|
#
|
|
87
87
|
# @since 4.0.0
|
|
@@ -16,7 +16,7 @@ require 'hiera/puppet_function'
|
|
|
16
16
|
#
|
|
17
17
|
# 1. A string key that Hiera searches for in the hierarchy. **Required**.
|
|
18
18
|
# 2. An optional default value to return if Hiera doesn't find anything matching the key.
|
|
19
|
-
# * If this argument isn't provided and this function results in a lookup failure,
|
|
19
|
+
# * If this argument isn't provided and this function results in a lookup failure, OpenVox
|
|
20
20
|
# fails with a compilation error.
|
|
21
21
|
# 3. The optional name of an arbitrary
|
|
22
22
|
# [hierarchy level](https://puppet.com/docs/hiera/latest/hierarchy.html) to insert at the
|
|
@@ -48,7 +48,7 @@ require 'hiera/puppet_function'
|
|
|
48
48
|
# ```
|
|
49
49
|
#
|
|
50
50
|
# You can optionally generate the default value with a
|
|
51
|
-
# [lambda](https://
|
|
51
|
+
# [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html) that
|
|
52
52
|
# takes one parameter.
|
|
53
53
|
#
|
|
54
54
|
# @example Using `hiera_array` with a lambda
|
|
@@ -64,12 +64,12 @@ require 'hiera/puppet_function'
|
|
|
64
64
|
# ```
|
|
65
65
|
#
|
|
66
66
|
# `hiera_array` expects that all values returned will be strings or arrays. If any matched
|
|
67
|
-
# value is a hash,
|
|
67
|
+
# value is a hash, OpenVox raises a type mismatch error.
|
|
68
68
|
#
|
|
69
69
|
# See
|
|
70
|
-
# [the 'Using the lookup function' documentation](https://
|
|
70
|
+
# [the 'Using the lookup function' documentation](https://docs.openvoxproject.org/openvox/latest/hiera_automatic.html) for how to perform lookup of data.
|
|
71
71
|
# Also see
|
|
72
|
-
# [the 'Using the deprecated hiera functions' documentation](https://
|
|
72
|
+
# [the 'Using the deprecated hiera functions' documentation](https://docs.openvoxproject.org/openvox/latest/hiera_automatic.html)
|
|
73
73
|
# for more information about the Hiera 3 functions.
|
|
74
74
|
#
|
|
75
75
|
# @since 4.0.0
|
|
@@ -21,7 +21,7 @@ require 'hiera/puppet_function'
|
|
|
21
21
|
#
|
|
22
22
|
# 1. A string key that Hiera searches for in the hierarchy. **Required**.
|
|
23
23
|
# 2. An optional default value to return if Hiera doesn't find anything matching the key.
|
|
24
|
-
# * If this argument isn't provided and this function results in a lookup failure,
|
|
24
|
+
# * If this argument isn't provided and this function results in a lookup failure, OpenVox
|
|
25
25
|
# fails with a compilation error.
|
|
26
26
|
# 3. The optional name of an arbitrary
|
|
27
27
|
# [hierarchy level](https://puppet.com/docs/hiera/latest/hierarchy.html) to insert at the
|
|
@@ -58,7 +58,7 @@ require 'hiera/puppet_function'
|
|
|
58
58
|
# ```
|
|
59
59
|
#
|
|
60
60
|
# You can optionally generate the default value with a
|
|
61
|
-
# [lambda](https://
|
|
61
|
+
# [lambda](https://docs.openvoxproject.org/openvox/latest/lang_lambdas.html) that
|
|
62
62
|
# takes one parameter.
|
|
63
63
|
#
|
|
64
64
|
# @example Using `hiera_hash` with a lambda
|
|
@@ -75,12 +75,12 @@ require 'hiera/puppet_function'
|
|
|
75
75
|
# ```
|
|
76
76
|
#
|
|
77
77
|
# `hiera_hash` expects that all values returned will be hashes. If any of the values
|
|
78
|
-
# found in the data sources are strings or arrays,
|
|
78
|
+
# found in the data sources are strings or arrays, OpenVox raises a type mismatch error.
|
|
79
79
|
#
|
|
80
80
|
# See
|
|
81
|
-
# [the 'Using the lookup function' documentation](https://
|
|
81
|
+
# [the 'Using the lookup function' documentation](https://docs.openvoxproject.org/openvox/latest/hiera_automatic.html) for how to perform lookup of data.
|
|
82
82
|
# Also see
|
|
83
|
-
# [the 'Using the deprecated hiera functions' documentation](https://
|
|
83
|
+
# [the 'Using the deprecated hiera functions' documentation](https://docs.openvoxproject.org/openvox/latest/hiera_automatic.html)
|
|
84
84
|
# for more information about the Hiera 3 functions.
|
|
85
85
|
#
|
|
86
86
|
# @since 4.0.0
|