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/man/man8/puppet-lookup.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET\-LOOKUP" "8" "
|
|
3
|
+
.TH "PUPPET\-LOOKUP" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\-lookup\fR \- Interactive Hiera lookup for OpenVox
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -14,7 +14,7 @@ The most common version of this command is:
|
|
|
14
14
|
.SH "USAGE"
|
|
15
15
|
puppet lookup [\-\-help] [\-\-type \fITYPESTRING\fR] [\-\-merge first|unique|hash|deep] [\-\-knock\-out\-prefix \fIPREFIX\-STRING\fR] [\-\-sort\-merged\-arrays] [\-\-merge\-hash\-arrays] [\-\-explain] [\-\-environment \fIENV\fR] [\-\-default \fIVALUE\fR] [\-\-node \fINODE\-NAME\fR] [\-\-facts \fIFILE\fR] [\-\-compile] [\-\-render\-as s|json|yaml|binary|msgpack] \fIkeys\fR
|
|
16
16
|
.SH "DESCRIPTION"
|
|
17
|
-
The lookup command is a CLI for
|
|
17
|
+
The lookup command is a CLI for OpenVox's 'lookup()' function\. It searches your Hiera data and returns a value for the requested lookup key, so you can test and explore your data\. It is a modern replacement for the 'hiera' command\. Lookup uses the setting for global hiera\.yaml from puppet's config, and the environment to find the environment level hiera\.yaml as well as the resulting modulepath for the environment (for hiera\.yaml files in modules)\. Hiera usually relies on a node's facts to locate the relevant data sources\. By default, 'puppet lookup' uses facts from the node you run the command on, but you can get data for any other node with the '\-\-node \fINAME\fR' option\. If possible, the lookup command will use the requested node's real stored facts from OpenVoxDB; if OpenVoxDB isn't configured or you want to provide arbitrary fact values, you can pass alternate facts as a JSON or YAML file with '\-\-facts \fIFILE\fR'\.
|
|
18
18
|
.P
|
|
19
19
|
If you're debugging your Hiera data and want to see where values are coming from, use the '\-\-explain' option\.
|
|
20
20
|
.P
|
|
@@ -22,18 +22,18 @@ If '\-\-explain' isn't specified, lookup exits with 0 if a value was found and 1
|
|
|
22
22
|
.P
|
|
23
23
|
You can provide multiple lookup keys to this command, but it only returns a value for the first found key, omitting the rest\.
|
|
24
24
|
.P
|
|
25
|
-
For more details about how Hiera works, see the Hiera documentation: https://
|
|
25
|
+
For more details about how Hiera works, see the Hiera documentation: https://docs\.openvoxproject\.org/openvox/latest/hiera_intro\.html
|
|
26
26
|
.SH "OPTIONS"
|
|
27
27
|
.IP "\(bu" 4
|
|
28
28
|
\-\-help: Print this help message\.
|
|
29
29
|
.IP "\(bu" 4
|
|
30
30
|
\-\-explain Explain the details of how the lookup was performed and where the final value came from (or the reason no value was found)\.
|
|
31
31
|
.IP "\(bu" 4
|
|
32
|
-
\-\-node \fINODE\-NAME\fR Specify which node to look up data for; defaults to the node where the command is run\. Since Hiera's purpose is to provide different values for different nodes (usually based on their facts), you'll usually want to use some specific node's facts to explore your data\. If the node where you're running this command is configured to talk to
|
|
32
|
+
\-\-node \fINODE\-NAME\fR Specify which node to look up data for; defaults to the node where the command is run\. Since Hiera's purpose is to provide different values for different nodes (usually based on their facts), you'll usually want to use some specific node's facts to explore your data\. If the node where you're running this command is configured to talk to OpenVoxDB, the command will use the requested node's most recent facts\. Otherwise, you can override facts with the '\-\-facts' option\.
|
|
33
33
|
.IP "\(bu" 4
|
|
34
34
|
\-\-facts \fIFILE\fR Specify a \.json or \.yaml file of key => value mappings to override the facts for this lookup\. Any facts not specified in this file maintain their original value\.
|
|
35
35
|
.IP "\(bu" 4
|
|
36
|
-
\-\-environment \fIENV\fR Like with most
|
|
36
|
+
\-\-environment \fIENV\fR Like with most OpenVox commands, you can specify an environment on the command line\. This is important for lookup because different environments can have different Hiera data\. This environment will be always be the one used regardless of any other factors\.
|
|
37
37
|
.IP "\(bu" 4
|
|
38
38
|
\-\-merge first|unique|hash|deep: Specify the merge behavior, overriding any merge behavior from the data's lookup_options\. 'first' returns the first value found\. 'unique' appends everything to a merged, deduplicated array\. 'hash' performs a simple hash merge by overwriting keys of lower lookup priority\. 'deep' performs a deep merge on values of Array and Hash type\. There are additional options that can be used with 'deep'\.
|
|
39
39
|
.IP "\(bu" 4
|
|
@@ -54,11 +54,11 @@ For more details about how Hiera works, see the Hiera documentation: https://pup
|
|
|
54
54
|
\-\-render\-as s|json|yaml|binary|msgpack Specify the output format of the results; "s" means plain text\. The default when producing a value is yaml and the default when producing an explanation is s\.
|
|
55
55
|
.IP "" 0
|
|
56
56
|
.SH "EXAMPLE"
|
|
57
|
-
To look up 'key_name' using the
|
|
57
|
+
To look up 'key_name' using the OpenVox Server node's facts: $ puppet lookup key_name
|
|
58
58
|
.P
|
|
59
|
-
To look up 'key_name' using the
|
|
59
|
+
To look up 'key_name' using the OpenVox Server node's arbitrary variables from a manifest, and classify the node if applicable: $ puppet lookup key_name \-\-compile
|
|
60
60
|
.P
|
|
61
|
-
To look up 'key_name' using the
|
|
61
|
+
To look up 'key_name' using the OpenVox Server node's facts, overridden by facts given in a file: $ puppet lookup key_name \-\-facts fact_file\.yaml
|
|
62
62
|
.P
|
|
63
63
|
To look up 'key_name' with agent\.local's facts: $ puppet lookup \-\-node agent\.local key_name
|
|
64
64
|
.P
|
data/man/man8/puppet-module.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET\-MODULE" "8" "
|
|
3
|
+
.TH "PUPPET\-MODULE" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\-module\fR \- Creates, installs and searches for modules on the Puppet Forge\.
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -10,7 +10,7 @@ This subcommand can find, install, and manage modules from the Puppet Forge, a r
|
|
|
10
10
|
.SH "OPTIONS"
|
|
11
11
|
Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
|
|
12
12
|
.P
|
|
13
|
-
See the configuration file documentation at \fIhttps://
|
|
13
|
+
See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
|
|
14
14
|
.TP
|
|
15
15
|
\-\-render\-as FORMAT
|
|
16
16
|
The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
|
|
@@ -22,18 +22,18 @@ Whether to log verbosely\.
|
|
|
22
22
|
Whether to log debug information\.
|
|
23
23
|
.TP
|
|
24
24
|
\-\-environment production
|
|
25
|
-
The environment in which
|
|
25
|
+
The environment in which OpenVox is running\. For clients, such as \fBpuppet agent\fR, this determines the environment itself, which OpenVox uses to find modules and much more\. For servers, such as OpenVox Server, this provides the default environment for nodes that OpenVox knows nothing about\.
|
|
26
26
|
.IP
|
|
27
27
|
When defining an environment in the \fB[agent]\fR section, this refers to the environment that the agent requests from the primary server\. The environment doesn't have to exist on the local filesystem because the agent fetches it from the primary server\. This definition is used when running \fBpuppet agent\fR\.
|
|
28
28
|
.IP
|
|
29
|
-
When defined in the \fB[user]\fR section, the environment refers to the path that
|
|
29
|
+
When defined in the \fB[user]\fR section, the environment refers to the path that OpenVox uses to search for code and modules related to its execution\. This requires the environment to exist locally on the filesystem where puppet is being executed\. OpenVox subcommands, including \fBpuppet module\fR and \fBpuppet apply\fR, use this definition\.
|
|
30
30
|
.IP
|
|
31
|
-
Given that the context and effects vary depending on the config section \fIhttps://
|
|
31
|
+
Given that the context and effects vary depending on the config section \fIhttps://docs\.openvoxproject\.org/openvox/latest/config_file_main\.html#config\-sections\fR in which the \fBenvironment\fR setting is defined, do not set it globally\.
|
|
32
32
|
.TP
|
|
33
33
|
\-\-modulepath
|
|
34
34
|
The search path for modules, as a list of directories separated by the system path separator character\. (The POSIX path separator is ':', and the Windows path separator is ';'\.)
|
|
35
35
|
.IP
|
|
36
|
-
Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but it can be overridden from the commandline)\. Please use directory environments instead\. If you need to use something other than the default modulepath of \fB<ACTIVE ENVIRONMENT'S MODULES DIR>:$basemodulepath\fR, you can set \fBmodulepath\fR in environment\.conf\. For more info, see \fIhttps://
|
|
36
|
+
Setting a global value for \fBmodulepath\fR in puppet\.conf is not allowed (but it can be overridden from the commandline)\. Please use directory environments instead\. If you need to use something other than the default modulepath of \fB<ACTIVE ENVIRONMENT'S MODULES DIR>:$basemodulepath\fR, you can set \fBmodulepath\fR in environment\.conf\. For more info, see \fIhttps://docs\.openvoxproject\.org/openvox/latest/environments_about\.html\fR
|
|
37
37
|
.SH "ACTIONS"
|
|
38
38
|
.TP
|
|
39
39
|
\fBchanges\fR \- Show modified files of an installed module\.
|
|
@@ -217,4 +217,4 @@ upgrade an installed module for a specific environment
|
|
|
217
217
|
.P
|
|
218
218
|
$ puppet module upgrade puppetlabs\-apache \-\-environment test /etc/puppetlabs/code/environments/test/modules └── puppetlabs\-apache (v1\.0\.0 \-> v2\.4\.0)
|
|
219
219
|
.SH "COPYRIGHT AND LICENSE"
|
|
220
|
-
Copyright 2012 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
|
|
220
|
+
Copyright 2012 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
|
data/man/man8/puppet-node.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET\-NODE" "8" "
|
|
3
|
+
.TH "PUPPET\-NODE" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\-node\fR \- View and manage node definitions\.
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -10,7 +10,7 @@ This subcommand interacts with node objects, which are used by OpenVox to build
|
|
|
10
10
|
.SH "OPTIONS"
|
|
11
11
|
Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
|
|
12
12
|
.P
|
|
13
|
-
See the configuration file documentation at \fIhttps://
|
|
13
|
+
See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
|
|
14
14
|
.TP
|
|
15
15
|
\-\-render\-as FORMAT
|
|
16
16
|
The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
|
|
@@ -22,21 +22,21 @@ Whether to log verbosely\.
|
|
|
22
22
|
Whether to log debug information\.
|
|
23
23
|
.TP
|
|
24
24
|
\-\-terminus _TERMINUS
|
|
25
|
-
Indirector faces expose indirected subsystems of
|
|
25
|
+
Indirector faces expose indirected subsystems of OpenVox\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In OpenVox parlance, these backends are called terminuses\.
|
|
26
26
|
.IP
|
|
27
|
-
Almost all indirected subsystems have a \fBrest\fR terminus that interacts with the
|
|
27
|
+
Almost all indirected subsystems have a \fBrest\fR terminus that interacts with the OpenVox server's data\. Most of them have additional terminuses for various local data models, which are in turn used by the indirected subsystem on the OpenVox server whenever it receives a remote request\.
|
|
28
28
|
.IP
|
|
29
29
|
The terminus for an action is often determined by context, but occasionally needs to be set explicitly\. See the "Notes" section of this face's manpage for more details\.
|
|
30
30
|
.SH "ACTIONS"
|
|
31
31
|
.TP
|
|
32
|
-
\fBclean\fR \- Clean up signed certs, cached facts, node objects, and reports for a node stored by the
|
|
32
|
+
\fBclean\fR \- Clean up signed certs, cached facts, node objects, and reports for a node stored by the OpenVox server
|
|
33
33
|
\fBSYNOPSIS\fR
|
|
34
34
|
.IP
|
|
35
35
|
puppet node clean [\-\-terminus _TERMINUS] \fIhost1\fR [\fIhost2\fR \|\.\|\.\|\.]
|
|
36
36
|
.IP
|
|
37
37
|
\fBDESCRIPTION\fR
|
|
38
38
|
.IP
|
|
39
|
-
Cleans up the following information
|
|
39
|
+
Cleans up the following information an OpenVox server knows about a node:
|
|
40
40
|
.IP
|
|
41
41
|
\fISigned certificates\fR \- ($vardir/ssl/ca/signed/node\.domain\.pem)
|
|
42
42
|
.IP
|
|
@@ -46,33 +46,7 @@ Cleans up the following information a puppet master knows about a node:
|
|
|
46
46
|
.IP
|
|
47
47
|
\fIReports\fR \- ($vardir/reports/node\.domain)
|
|
48
48
|
.IP
|
|
49
|
-
NOTE: this action now cleans up certs via
|
|
50
|
-
.TP
|
|
51
|
-
\fBdecrypt\fR \- Decrypt a value using the agent's own certificate
|
|
52
|
-
\fBSYNOPSIS\fR
|
|
53
|
-
.IP
|
|
54
|
-
puppet node decrypt [\-\-terminus _TERMINUS] [\-d DATA | \-\-data DATA] [\-e VARIABLE | \-\-env VARIABLE]
|
|
55
|
-
.IP
|
|
56
|
-
\fBDESCRIPTION\fR
|
|
57
|
-
.IP
|
|
58
|
-
Decrypt a value using the agent's own certificate\. You have three ways to pass data for decryption\. You can pass it directly on the command line (if your kernel allows command strings that long), you can set it in an environment variable and pass the name of the variable, or you can pipe it using STDIN\.
|
|
59
|
-
.IP
|
|
60
|
-
\fBOPTIONS\fR \fI\-d DATA\fR | \fI\-\-data DATA\fR \- An string of data to decrypt
|
|
61
|
-
.IP
|
|
62
|
-
\fI\-e VARIABLE\fR | \fI\-\-env VARIABLE\fR \- An environment variable containing data to decrypt
|
|
63
|
-
.TP
|
|
64
|
-
\fBencrypt\fR \- Encrypt a value using a specified agent's certificate
|
|
65
|
-
\fBSYNOPSIS\fR
|
|
66
|
-
.IP
|
|
67
|
-
puppet node encrypt [\-\-terminus _TERMINUS] [\-t CERTNAME | \-\-target CERTNAME] \fIstring\fR
|
|
68
|
-
.IP
|
|
69
|
-
\fBDESCRIPTION\fR
|
|
70
|
-
.IP
|
|
71
|
-
Encrypt a value using a specified agent's certificate useful for pasting into a manifest for a node_encrypted_file resource type, or for a data value for a datacat fragment\.
|
|
72
|
-
.IP
|
|
73
|
-
This will only run properly on a CA node with access to each node's signed public certificate\.
|
|
74
|
-
.IP
|
|
75
|
-
\fBOPTIONS\fR \fI\-t CERTNAME\fR | \fI\-\-target CERTNAME\fR \- Which agent to encrypt for
|
|
49
|
+
NOTE: this action now cleans up certs via OpenVox Server's CA API\. A running server is required for certs to be cleaned\.
|
|
76
50
|
.TP
|
|
77
51
|
\fBfind\fR \- Retrieve a node object\.
|
|
78
52
|
\fBSYNOPSIS\fR
|
|
@@ -98,29 +72,21 @@ puppet node info [\-\-terminus _TERMINUS]
|
|
|
98
72
|
.IP
|
|
99
73
|
Prints the default terminus class for this subcommand\. Note that different run modes may have different default termini; when in doubt, specify the run mode with the '\-\-run_mode' option\.
|
|
100
74
|
.SH "EXAMPLES"
|
|
101
|
-
\fBdecrypt\fR
|
|
102
|
-
.P
|
|
103
|
-
$ puppet node decrypt \-\-data \fIencrypted blob of data\fR $ puppet node decrypt \-\-env \fIenvironment variable containing blob of encrypted data\fR $ echo \fIencrypted blob of data\fR | puppet node decrypt $ cat /file/with/encrypted/blob\.txt | puppet node decrypt
|
|
104
|
-
.P
|
|
105
|
-
\fBencrypt\fR
|
|
106
|
-
.P
|
|
107
|
-
$ puppet node encrypt \-\-certname testhost\.example\.com "some text to encrypt"
|
|
108
|
-
.P
|
|
109
75
|
\fBfind\fR
|
|
110
76
|
.P
|
|
111
77
|
Retrieve an "empty" (no classes, no ENC\-imposed parameters, and an environment of "production") node:
|
|
112
78
|
.P
|
|
113
79
|
$ puppet node find somenode\.puppetlabs\.lan \-\-terminus plain \-\-render\-as yaml
|
|
114
80
|
.P
|
|
115
|
-
Retrieve a node using the
|
|
81
|
+
Retrieve a node using the OpenVox Server's configured ENC:
|
|
116
82
|
.P
|
|
117
83
|
$ puppet node find somenode\.puppetlabs\.lan \-\-terminus exec \-\-run_mode server \-\-render\-as yaml
|
|
118
84
|
.P
|
|
119
|
-
Retrieve the same node from the
|
|
85
|
+
Retrieve the same node from the OpenVox Server:
|
|
120
86
|
.P
|
|
121
87
|
$ puppet node find somenode\.puppetlabs\.lan \-\-terminus rest \-\-render\-as yaml
|
|
122
88
|
.SH "NOTES"
|
|
123
|
-
This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of
|
|
89
|
+
This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of OpenVox\. Valid termini for this face include:
|
|
124
90
|
.IP "\(bu" 4
|
|
125
91
|
\fBexec\fR
|
|
126
92
|
.IP "\(bu" 4
|
|
@@ -139,4 +105,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
|
|
|
139
105
|
\fByaml\fR
|
|
140
106
|
.IP "" 0
|
|
141
107
|
.SH "COPYRIGHT AND LICENSE"
|
|
142
|
-
Copyright 2011 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
|
|
108
|
+
Copyright 2011 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
|
data/man/man8/puppet-parser.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET\-PARSER" "8" "
|
|
3
|
+
.TH "PUPPET\-PARSER" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\-parser\fR \- Interact directly with the parser\.
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -8,7 +8,7 @@ puppet parser \fIaction\fR
|
|
|
8
8
|
.SH "OPTIONS"
|
|
9
9
|
Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
|
|
10
10
|
.P
|
|
11
|
-
See the configuration file documentation at \fIhttps://
|
|
11
|
+
See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
|
|
12
12
|
.TP
|
|
13
13
|
\-\-render\-as FORMAT
|
|
14
14
|
The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
|
|
@@ -84,4 +84,4 @@ Validate from STDIN:
|
|
|
84
84
|
.P
|
|
85
85
|
$ cat init\.pp | puppet parser validate
|
|
86
86
|
.SH "COPYRIGHT AND LICENSE"
|
|
87
|
-
Copyright 2014 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
|
|
87
|
+
Copyright 2014 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
|
data/man/man8/puppet-plugin.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET\-PLUGIN" "8" "
|
|
3
|
+
.TH "PUPPET\-PLUGIN" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\-plugin\fR \- Interact with the OpenVox plugin system\.
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -8,11 +8,11 @@ puppet plugin \fIaction\fR
|
|
|
8
8
|
.SH "DESCRIPTION"
|
|
9
9
|
This subcommand provides network access to the OpenVox server's store of plugins\.
|
|
10
10
|
.P
|
|
11
|
-
The OpenVox server serves Ruby code collected from the \fBlib\fR directories of its modules\. These plugins can be used on agent nodes to extend
|
|
11
|
+
The OpenVox server serves Ruby code collected from the \fBlib\fR directories of its modules\. These plugins can be used on agent nodes to extend OpenFact and implement custom types and providers\. Plugins are normally downloaded by the OpenVox agent during the course of a run\.
|
|
12
12
|
.SH "OPTIONS"
|
|
13
13
|
Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
|
|
14
14
|
.P
|
|
15
|
-
See the configuration file documentation at \fIhttps://
|
|
15
|
+
See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
|
|
16
16
|
.TP
|
|
17
17
|
\-\-render\-as FORMAT
|
|
18
18
|
The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
|
|
@@ -24,7 +24,7 @@ Whether to log verbosely\.
|
|
|
24
24
|
Whether to log debug information\.
|
|
25
25
|
.SH "ACTIONS"
|
|
26
26
|
.TP
|
|
27
|
-
\fBdownload\fR \- Download plugins from the
|
|
27
|
+
\fBdownload\fR \- Download plugins from the OpenVox server\.
|
|
28
28
|
\fBSYNOPSIS\fR
|
|
29
29
|
.IP
|
|
30
30
|
puppet plugin download
|
|
@@ -39,12 +39,12 @@ A list of the files downloaded, or a confirmation that no files were downloaded\
|
|
|
39
39
|
.SH "EXAMPLES"
|
|
40
40
|
\fBdownload\fR
|
|
41
41
|
.P
|
|
42
|
-
Retrieve plugins from the
|
|
42
|
+
Retrieve plugins from the OpenVox server:
|
|
43
43
|
.P
|
|
44
44
|
$ puppet plugin download
|
|
45
45
|
.P
|
|
46
|
-
Retrieve plugins from the
|
|
46
|
+
Retrieve plugins from the OpenVox server (API example):
|
|
47
47
|
.P
|
|
48
48
|
$ Puppet::Face[:plugin, '0\.0\.1']\.download
|
|
49
49
|
.SH "COPYRIGHT AND LICENSE"
|
|
50
|
-
Copyright 2011 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
|
|
50
|
+
Copyright 2011 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
|
data/man/man8/puppet-report.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET\-REPORT" "8" "
|
|
3
|
+
.TH "PUPPET\-REPORT" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\-report\fR \- Create, display, and submit reports\.
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -8,7 +8,7 @@ puppet report \fIaction\fR [\-\-terminus _TERMINUS]
|
|
|
8
8
|
.SH "OPTIONS"
|
|
9
9
|
Note that any setting that's valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR and \fBrun_mode\fR are valid settings, so you can specify \fB\-\-server <servername>\fR, or \fB\-\-run_mode <runmode>\fR as an argument\.
|
|
10
10
|
.P
|
|
11
|
-
See the configuration file documentation at \fIhttps://
|
|
11
|
+
See the configuration file documentation at \fIhttps://docs\.openvoxproject\.org/openvox/latest/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
|
|
12
12
|
.TP
|
|
13
13
|
\-\-render\-as FORMAT
|
|
14
14
|
The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
|
|
@@ -20,9 +20,9 @@ Whether to log verbosely\.
|
|
|
20
20
|
Whether to log debug information\.
|
|
21
21
|
.TP
|
|
22
22
|
\-\-terminus _TERMINUS
|
|
23
|
-
Indirector faces expose indirected subsystems of
|
|
23
|
+
Indirector faces expose indirected subsystems of OpenVox\. These subsystems are each able to retrieve and alter a specific type of data (with the familiar actions of \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR) from an arbitrary number of pluggable backends\. In OpenVox parlance, these backends are called terminuses\.
|
|
24
24
|
.IP
|
|
25
|
-
Almost all indirected subsystems have a \fBrest\fR terminus that interacts with the
|
|
25
|
+
Almost all indirected subsystems have a \fBrest\fR terminus that interacts with the OpenVox server's data\. Most of them have additional terminuses for various local data models, which are in turn used by the indirected subsystem on the OpenVox server whenever it receives a remote request\.
|
|
26
26
|
.IP
|
|
27
27
|
The terminus for an action is often determined by context, but occasionally needs to be set explicitly\. See the "Notes" section of this face's manpage for more details\.
|
|
28
28
|
.SH "ACTIONS"
|
|
@@ -68,7 +68,7 @@ begin Puppet::Transaction::Report\.indirection\.terminus_class = :rest Puppet::F
|
|
|
68
68
|
.P
|
|
69
69
|
API example:report = Puppet::Face[:catalog, '0\.0\.1']\.apply Puppet::Face[:report, '0\.0\.1']\.submit(report) return report
|
|
70
70
|
.SH "NOTES"
|
|
71
|
-
This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of
|
|
71
|
+
This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \fBsave\fR, and \fBdestroy\fR actions for an indirected subsystem of OpenVox\. Valid termini for this face include:
|
|
72
72
|
.IP "\(bu" 4
|
|
73
73
|
\fBjson\fR
|
|
74
74
|
.IP "\(bu" 4
|
|
@@ -81,4 +81,4 @@ This subcommand is an indirector face, which exposes \fBfind\fR, \fBsearch\fR, \
|
|
|
81
81
|
\fByaml\fR
|
|
82
82
|
.IP "" 0
|
|
83
83
|
.SH "COPYRIGHT AND LICENSE"
|
|
84
|
-
Copyright 2011 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING
|
|
84
|
+
Copyright 2011 by Puppet Inc\., Vox Pupuli\. Apache 2 license; see COPYING
|
data/man/man8/puppet-resource.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET\-RESOURCE" "8" "
|
|
3
|
+
.TH "PUPPET\-RESOURCE" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\-resource\fR \- The OpenVox resource abstraction layer shell
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -8,15 +8,15 @@ Uses the OpenVox RAL to directly interact with the system\.
|
|
|
8
8
|
.SH "USAGE"
|
|
9
9
|
puppet resource [\-h|\-\-help] [\-d|\-\-debug] [\-v|\-\-verbose] [\-e|\-\-edit] [\-p|\-\-param \fIparameter\fR] [\-t|\-\-types] [\-y|\-\-to_yaml] \fItype\fR [\fIname\fR] [\fIattribute\fR=\fIvalue\fR \|\.\|\.\|\.]
|
|
10
10
|
.SH "DESCRIPTION"
|
|
11
|
-
This command provides simple facilities for converting current system state into Puppet code, along with some ability to modify the current state using
|
|
11
|
+
This command provides simple facilities for converting current system state into Puppet code, along with some ability to modify the current state using the OpenVox RAL\.
|
|
12
12
|
.P
|
|
13
13
|
By default, you must at least provide a type to list, in which case puppet resource will tell you everything it knows about all resources of that type\. You can optionally specify an instance name, and puppet resource will only describe that single instance\.
|
|
14
14
|
.P
|
|
15
|
-
If given a type, a name, and a series of \fIattribute\fR=\fIvalue\fR pairs, puppet resource will modify the state of the specified resource\. Alternately, if given a type, a name, and the '\-\-edit' flag, puppet resource will write its output to a file, open that file in an editor, and then apply the saved file as
|
|
15
|
+
If given a type, a name, and a series of \fIattribute\fR=\fIvalue\fR pairs, puppet resource will modify the state of the specified resource\. Alternately, if given a type, a name, and the '\-\-edit' flag, puppet resource will write its output to a file, open that file in an editor, and then apply the saved file as an OpenVox transaction\.
|
|
16
16
|
.SH "OPTIONS"
|
|
17
17
|
Note that any setting that's valid in the configuration file is also a valid long argument\. For example, 'ssldir' is a valid setting, so you can specify '\-\-ssldir \fIdirectory\fR' as an argument\.
|
|
18
18
|
.P
|
|
19
|
-
See the configuration file documentation at https://
|
|
19
|
+
See the configuration file documentation at https://docs\.openvoxproject\.org/openvox/latest/configuration\.html for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with '\-\-genconfig'\.
|
|
20
20
|
.TP
|
|
21
21
|
\-\-debug
|
|
22
22
|
Enable full debugging\.
|
|
@@ -60,4 +60,4 @@ user { 'luke':
|
|
|
60
60
|
.SH "AUTHOR"
|
|
61
61
|
Luke Kanies
|
|
62
62
|
.SH "COPYRIGHT"
|
|
63
|
-
Copyright (c) 2011 Puppet Inc
|
|
63
|
+
Copyright (c) 2011 Puppet Inc\.; Copyright (c) 2024 Vox Pupuli\. Licensed under the Apache 2\.0 License
|
data/man/man8/puppet-script.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET\-SCRIPT" "8" "
|
|
3
|
+
.TH "PUPPET\-SCRIPT" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\-script\fR \- Run a puppet manifests as a script without compiling a catalog
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -14,7 +14,7 @@ When provided with a modulepath, via command line or config file, puppet script
|
|
|
14
14
|
.SH "OPTIONS"
|
|
15
15
|
Note that any setting that's valid in the configuration file is also a valid long argument\. For example, 'environment' is a valid setting, so you can specify '\-\-environment mytest' as an argument\.
|
|
16
16
|
.P
|
|
17
|
-
See the configuration file documentation at https://
|
|
17
|
+
See the configuration file documentation at https://docs\.openvoxproject\.org/openvox/latest/configuration\.html for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with '\-\-genconfig'\.
|
|
18
18
|
.TP
|
|
19
19
|
\-\-debug
|
|
20
20
|
Enable full debugging\.
|
|
@@ -30,7 +30,7 @@ A path ending with '\.json' will receive structured output in JSON format\. The
|
|
|
30
30
|
A path ending with '\.jsonl' will receive structured output in JSON Lines format\.
|
|
31
31
|
.TP
|
|
32
32
|
\-\-noop
|
|
33
|
-
Use 'noop' mode where
|
|
33
|
+
Use 'noop' mode where OpenVox runs in a no\-op or dry\-run mode\. This is useful for seeing what changes OpenVox will make without actually executing the changes\. Applies to tasks only\.
|
|
34
34
|
.TP
|
|
35
35
|
\-\-execute
|
|
36
36
|
Execute a specific piece of Puppet code
|
data/man/man8/puppet-ssl.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET\-SSL" "8" "
|
|
3
|
+
.TH "PUPPET\-SSL" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\-ssl\fR \- Manage SSL keys and certificates for OpenVox SSL clients
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -18,28 +18,26 @@ puppet ssl \fIaction\fR [\-h|\-\-help] [\-v|\-\-verbose] [\-d|\-\-debug] [\-\-lo
|
|
|
18
18
|
\-\-localca Also clean the local CA certificate and CRL\.
|
|
19
19
|
.IP "\(bu" 4
|
|
20
20
|
\-\-target CERTNAME Clean the specified device certificate instead of this host's certificate\.
|
|
21
|
+
.IP "\(bu" 4
|
|
22
|
+
\-\-if\-expiring\-in DURATION When renewing a certificate only renew if the certificate is valid for less than this amount of time\. Duration can be specified as a time interval, such as 30s, 5m, 1h\.
|
|
21
23
|
.IP "" 0
|
|
22
24
|
.SH "ACTIONS"
|
|
23
|
-
.
|
|
24
|
-
bootstrap
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
Generate a certificate signing request (CSR)
|
|
29
|
-
.
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
.
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
Remove the private key and certificate related files for this host\. If \fB\-\-localca\fR is specified, then also remove this host's local copy of the CA certificate(s) and CRL bundle\. if \fB\-\-target CERTNAME\fR is specified, then remove the files for the specified device on this host instead of this host\.
|
|
41
|
-
.TP
|
|
42
|
-
show
|
|
43
|
-
Print the full\-text version of this host's certificate\.
|
|
25
|
+
.IP "\(bu" 4
|
|
26
|
+
bootstrap: Perform all of the steps necessary to request and download a client certificate\. If autosigning is disabled, then puppet will wait every \fBwaitforcert\fR seconds for its certificate to be signed\. To only attempt once and never wait, specify a time of 0\. Since \fBwaitforcert\fR is an OpenVox setting, it can be specified as a time interval, such as 30s, 5m, 1h\.
|
|
27
|
+
.IP "\(bu" 4
|
|
28
|
+
submit_request: Generate a certificate signing request (CSR) and submit it to the CA\. If a private and public key pair already exist, they will be used to generate the CSR\. Otherwise, a new key pair will be generated\. If a CSR has already been submitted with the given \fBcertname\fR, then the operation will fail\.
|
|
29
|
+
.IP "\(bu" 4
|
|
30
|
+
generate_request: Generate a certificate signing request (CSR)\. If a private and public key pair exist, they will be used to generate the CSR\. Otherwise a new key pair will be generated\.
|
|
31
|
+
.IP "\(bu" 4
|
|
32
|
+
download_cert: Download a certificate for this host\. If the current private key matches the downloaded certificate, then the certificate will be saved and used for subsequent requests\. If there is already an existing certificate, it will be overwritten\.
|
|
33
|
+
.IP "\(bu" 4
|
|
34
|
+
renew_cert Renew an existing and non\-expired client certificate\. When \fB\-\-if\-expiring\-in\fR option is specified, then renew the certificate only if it's going to expire in the amount of time given\.
|
|
35
|
+
.IP "\(bu" 4
|
|
36
|
+
verify: Verify the private key and certificate are present and match, verify the certificate is issued by a trusted CA, and check revocation status\.
|
|
37
|
+
.IP "\(bu" 4
|
|
38
|
+
clean: Remove the private key and certificate related files for this host\. If \fB\-\-localca\fR is specified, then also remove this host's local copy of the CA certificate(s) and CRL bundle\. if \fB\-\-target CERTNAME\fR is specified, then remove the files for the specified device on this host instead of this host\.
|
|
39
|
+
.IP "\(bu" 4
|
|
40
|
+
show: Print the full\-text version of this host's certificate\.
|
|
41
|
+
.IP "" 0
|
|
44
42
|
.P
|
|
45
|
-
COPYRIGHT \-\-\-\-\-\- Copyright (c) 2011 Puppet Inc
|
|
43
|
+
COPYRIGHT \-\-\-\-\-\- Copyright (c) 2011 Puppet Inc\.; Copyright (c) 2024 Vox Pupuli\. Licensed under the Apache 2\.0 License
|
data/man/man8/puppet.8
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
.\" generated with Ronn-NG/v0.10.1
|
|
2
2
|
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
|
3
|
-
.TH "PUPPET" "8" "
|
|
3
|
+
.TH "PUPPET" "8" "August 2026" "Vox Pupuli" "OpenVox manual"
|
|
4
4
|
.SH "NAME"
|
|
5
5
|
\fBpuppet\fR \- OpenVox is an automated configuration management tool
|
|
6
6
|
.SH "SYNOPSIS"
|
|
@@ -39,7 +39,7 @@ OpenVox is a community implementation of Puppet, an automated administrative eng
|
|
|
39
39
|
.SS "Specialized"
|
|
40
40
|
\fBstrings\fR
|
|
41
41
|
.br
|
|
42
|
-
\~\~\~\~Generate Puppet documentation with YARD\.
|
|
42
|
+
\~\~\~\~Generate Puppet module documentation with YARD\.
|
|
43
43
|
.P
|
|
44
44
|
\fBcatalog\fR
|
|
45
45
|
.br
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: openvox
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 9.0.0.pre.
|
|
4
|
+
version: 9.0.0.pre.beta2
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- OpenVox Project
|
|
@@ -145,14 +145,14 @@ dependencies:
|
|
|
145
145
|
requirements:
|
|
146
146
|
- - "~>"
|
|
147
147
|
- !ruby/object:Gem::Version
|
|
148
|
-
version: '
|
|
148
|
+
version: '6.0'
|
|
149
149
|
type: :runtime
|
|
150
150
|
prerelease: false
|
|
151
151
|
version_requirements: !ruby/object:Gem::Requirement
|
|
152
152
|
requirements:
|
|
153
153
|
- - "~>"
|
|
154
154
|
- !ruby/object:Gem::Version
|
|
155
|
-
version: '
|
|
155
|
+
version: '6.0'
|
|
156
156
|
- !ruby/object:Gem::Dependency
|
|
157
157
|
name: ostruct
|
|
158
158
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -602,7 +602,6 @@ files:
|
|
|
602
602
|
- lib/puppet/indirector/file_metadata/selector.rb
|
|
603
603
|
- lib/puppet/indirector/file_server.rb
|
|
604
604
|
- lib/puppet/indirector/generic_http.rb
|
|
605
|
-
- lib/puppet/indirector/hiera.rb
|
|
606
605
|
- lib/puppet/indirector/indirection.rb
|
|
607
606
|
- lib/puppet/indirector/json.rb
|
|
608
607
|
- lib/puppet/indirector/memory.rb
|
|
@@ -1257,8 +1256,6 @@ files:
|
|
|
1257
1256
|
- lib/puppet/util/psych_support.rb
|
|
1258
1257
|
- lib/puppet/util/rdoc.rb
|
|
1259
1258
|
- lib/puppet/util/rdoc/code_objects.rb
|
|
1260
|
-
- lib/puppet/util/rdoc/generators/puppet_generator.rb
|
|
1261
|
-
- lib/puppet/util/rdoc/generators/template/puppet/puppet.rb
|
|
1262
1259
|
- lib/puppet/util/rdoc/parser.rb
|
|
1263
1260
|
- lib/puppet/util/rdoc/parser/puppet_parser_core.rb
|
|
1264
1261
|
- lib/puppet/util/rdoc/parser/puppet_parser_rdoc2.rb
|
|
@@ -1359,14 +1356,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
|
1359
1356
|
requirements:
|
|
1360
1357
|
- - ">="
|
|
1361
1358
|
- !ruby/object:Gem::Version
|
|
1362
|
-
version: 3.
|
|
1359
|
+
version: 3.2.0
|
|
1363
1360
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
|
1364
1361
|
requirements:
|
|
1365
1362
|
- - ">"
|
|
1366
1363
|
- !ruby/object:Gem::Version
|
|
1367
1364
|
version: 1.3.1
|
|
1368
1365
|
requirements: []
|
|
1369
|
-
rubygems_version: 4.0.
|
|
1366
|
+
rubygems_version: 4.0.16
|
|
1370
1367
|
specification_version: 4
|
|
1371
1368
|
summary: OpenVox, a community implementation of Puppet -- an automated configuration
|
|
1372
1369
|
management tool
|