puppet 6.15.0-x64-mingw32 → 6.19.1-x64-mingw32
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.
Potentially problematic release.
This version of puppet might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/CODEOWNERS +2 -7
- data/Gemfile +4 -2
- data/Gemfile.lock +29 -27
- data/README.md +3 -4
- data/Rakefile +4 -12
- data/lib/puppet.rb +32 -8
- data/lib/puppet/agent.rb +18 -4
- data/lib/puppet/agent/locker.rb +0 -7
- data/lib/puppet/application/agent.rb +23 -8
- data/lib/puppet/application/apply.rb +18 -20
- data/lib/puppet/application/device.rb +1 -1
- data/lib/puppet/application/doc.rb +1 -1
- data/lib/puppet/application/lookup.rb +16 -4
- data/lib/puppet/application/plugin.rb +1 -0
- data/lib/puppet/application/ssl.rb +1 -1
- data/lib/puppet/configurer.rb +61 -21
- data/lib/puppet/configurer/downloader.rb +31 -10
- data/lib/puppet/confine.rb +2 -2
- data/lib/puppet/confine/any.rb +1 -1
- data/lib/puppet/context/trusted_information.rb +14 -8
- data/lib/puppet/daemon.rb +13 -27
- data/lib/puppet/defaults.rb +119 -39
- data/lib/puppet/environments.rb +51 -10
- data/lib/puppet/face/catalog.rb +1 -1
- data/lib/puppet/face/config.rb +46 -16
- data/lib/puppet/face/facts.rb +1 -1
- data/lib/puppet/face/help.rb +29 -3
- data/lib/puppet/face/module/search.rb +5 -0
- data/lib/puppet/face/node.rb +3 -3
- data/lib/puppet/face/node/clean.rb +2 -2
- data/lib/puppet/face/plugin.rb +1 -1
- data/lib/puppet/face/status.rb +1 -1
- data/lib/puppet/feature/base.rb +1 -1
- data/lib/puppet/file_bucket/dipper.rb +1 -1
- data/lib/puppet/file_serving/http_metadata.rb +14 -2
- data/lib/puppet/file_serving/metadata.rb +4 -1
- data/lib/puppet/file_serving/mount/locales.rb +1 -2
- data/lib/puppet/file_serving/mount/pluginfacts.rb +1 -2
- data/lib/puppet/file_serving/mount/plugins.rb +1 -2
- data/lib/puppet/file_serving/terminus_selector.rb +7 -8
- data/lib/puppet/file_system/file_impl.rb +4 -4
- data/lib/puppet/file_system/uniquefile.rb +12 -16
- data/lib/puppet/forge.rb +1 -1
- data/lib/puppet/forge/cache.rb +1 -1
- data/lib/puppet/forge/repository.rb +4 -7
- data/lib/puppet/functions/filter.rb +1 -0
- data/lib/puppet/functions/lstrip.rb +4 -4
- data/lib/puppet/functions/new.rb +8 -3
- data/lib/puppet/functions/reverse_each.rb +1 -1
- data/lib/puppet/functions/rstrip.rb +4 -4
- data/lib/puppet/functions/step.rb +1 -1
- data/lib/puppet/functions/strip.rb +4 -4
- data/lib/puppet/gettext/config.rb +5 -5
- data/lib/puppet/gettext/module_translations.rb +4 -4
- data/lib/puppet/http.rb +1 -0
- data/lib/puppet/http/client.rb +28 -12
- data/lib/puppet/http/external_client.rb +0 -6
- data/lib/puppet/http/redirector.rb +9 -7
- data/lib/puppet/http/resolver.rb +5 -8
- data/lib/puppet/http/resolver/server_list.rb +18 -36
- data/lib/puppet/http/resolver/settings.rb +4 -4
- data/lib/puppet/http/resolver/srv.rb +5 -5
- data/lib/puppet/http/response.rb +19 -0
- data/lib/puppet/http/service.rb +3 -1
- data/lib/puppet/http/service/compiler.rb +1 -1
- data/lib/puppet/http/service/file_server.rb +1 -1
- data/lib/puppet/http/service/puppetserver.rb +39 -0
- data/lib/puppet/http/session.rb +5 -4
- data/lib/puppet/indirector.rb +1 -1
- data/lib/puppet/indirector/catalog/compiler.rb +1 -1
- data/lib/puppet/indirector/exec.rb +1 -1
- data/lib/puppet/indirector/facts/facter.rb +3 -3
- data/lib/puppet/indirector/facts/yaml.rb +1 -1
- data/lib/puppet/indirector/file_content/http.rb +5 -0
- data/lib/puppet/indirector/file_content/rest.rb +1 -1
- data/lib/puppet/indirector/file_metadata/http.rb +28 -8
- data/lib/puppet/indirector/file_metadata/rest.rb +2 -2
- data/lib/puppet/indirector/hiera.rb +4 -0
- data/lib/puppet/indirector/indirection.rb +1 -1
- data/lib/puppet/indirector/json.rb +1 -1
- data/lib/puppet/indirector/msgpack.rb +1 -1
- data/lib/puppet/indirector/report/processor.rb +2 -2
- data/lib/puppet/indirector/request.rb +5 -5
- data/lib/puppet/indirector/rest.rb +7 -1
- data/lib/puppet/indirector/yaml.rb +1 -1
- data/lib/puppet/module.rb +1 -2
- data/lib/puppet/network/format_support.rb +2 -2
- data/lib/puppet/network/http/api/indirected_routes.rb +1 -1
- data/lib/puppet/network/http/api/master/v3/environment.rb +3 -0
- data/lib/puppet/network/http/api/master/v3/environments.rb +0 -1
- data/lib/puppet/network/http/compression.rb +7 -0
- data/lib/puppet/network/http/connection.rb +2 -0
- data/lib/puppet/network/http/connection_adapter.rb +184 -0
- data/lib/puppet/network/http/nocache_pool.rb +1 -0
- data/lib/puppet/network/http/route.rb +2 -2
- data/lib/puppet/network/http_pool.rb +2 -2
- data/lib/puppet/node/environment.rb +12 -5
- data/lib/puppet/node/facts.rb +17 -0
- data/lib/puppet/pal/catalog_compiler.rb +5 -0
- data/lib/puppet/pal/pal_impl.rb +31 -4
- data/lib/puppet/parameter.rb +1 -1
- data/lib/puppet/parser/ast/leaf.rb +5 -5
- data/lib/puppet/parser/ast/pops_bridge.rb +0 -4
- data/lib/puppet/parser/compiler.rb +29 -26
- data/lib/puppet/parser/compiler/catalog_validator/env_relationship_validator.rb +2 -0
- data/lib/puppet/parser/compiler/catalog_validator/site_validator.rb +2 -0
- data/lib/puppet/parser/environment_compiler.rb +4 -1
- data/lib/puppet/parser/functions.rb +21 -17
- data/lib/puppet/parser/functions/create_resources.rb +11 -7
- data/lib/puppet/parser/functions/filter.rb +1 -0
- data/lib/puppet/parser/resource.rb +3 -2
- data/lib/puppet/parser/resource/param.rb +6 -0
- data/lib/puppet/parser/type_loader.rb +2 -2
- data/lib/puppet/pops/adaptable.rb +7 -13
- data/lib/puppet/pops/adapters.rb +8 -4
- data/lib/puppet/pops/evaluator/collectors/abstract_collector.rb +1 -3
- data/lib/puppet/pops/evaluator/evaluator_impl.rb +5 -5
- data/lib/puppet/pops/evaluator/runtime3_converter.rb +2 -2
- data/lib/puppet/pops/issues.rb +5 -0
- data/lib/puppet/pops/loader/runtime3_type_loader.rb +4 -2
- data/lib/puppet/pops/loaders.rb +18 -11
- data/lib/puppet/pops/lookup/context.rb +1 -1
- data/lib/puppet/pops/lookup/hiera_config.rb +14 -1
- data/lib/puppet/pops/resource/resource_type_impl.rb +2 -0
- data/lib/puppet/pops/types/iterable.rb +34 -8
- data/lib/puppet/pops/types/p_meta_type.rb +1 -1
- data/lib/puppet/pops/types/p_type_set_type.rb +4 -0
- data/lib/puppet/pops/validation/checker4_0.rb +29 -15
- data/lib/puppet/pops/validation/validator_factory_4_0.rb +1 -0
- data/lib/puppet/provider/file/windows.rb +1 -1
- data/lib/puppet/provider/package/aix.rb +17 -2
- data/lib/puppet/provider/package/apt.rb +38 -1
- data/lib/puppet/provider/package/aptitude.rb +1 -1
- data/lib/puppet/provider/package/dnfmodule.rb +24 -4
- data/lib/puppet/provider/package/dpkg.rb +1 -1
- data/lib/puppet/provider/package/gem.rb +4 -2
- data/lib/puppet/provider/package/pip.rb +60 -37
- data/lib/puppet/provider/package/pip2.rb +17 -0
- data/lib/puppet/provider/package/portage.rb +2 -2
- data/lib/puppet/provider/package/puppet_gem.rb +5 -0
- data/lib/puppet/provider/package/puppetserver_gem.rb +180 -0
- data/lib/puppet/provider/package/yum.rb +9 -1
- data/lib/puppet/provider/package/zypper.rb +62 -1
- data/lib/puppet/provider/service/systemd.rb +21 -4
- data/lib/puppet/provider/service/windows.rb +23 -7
- data/lib/puppet/provider/user/aix.rb +1 -1
- data/lib/puppet/provider/user/user_role_add.rb +1 -1
- data/lib/puppet/provider/user/useradd.rb +16 -5
- data/lib/puppet/provider/user/windows_adsi.rb +18 -1
- data/lib/puppet/reports/http.rb +7 -3
- data/lib/puppet/resource.rb +2 -1
- data/lib/puppet/resource/type.rb +10 -1
- data/lib/puppet/rest/route.rb +2 -2
- data/lib/puppet/runtime.rb +25 -2
- data/lib/puppet/settings.rb +43 -6
- data/lib/puppet/ssl/ssl_context.rb +2 -2
- data/lib/puppet/ssl/ssl_provider.rb +20 -1
- data/lib/puppet/ssl/state_machine.rb +33 -8
- data/lib/puppet/ssl/validator/default_validator.rb +1 -1
- data/lib/puppet/ssl/verifier_adapter.rb +9 -1
- data/lib/puppet/test/test_helper.rb +19 -14
- data/lib/puppet/transaction.rb +2 -2
- data/lib/puppet/transaction/persistence.rb +1 -1
- data/lib/puppet/transaction/report.rb +12 -8
- data/lib/puppet/trusted_external.rb +29 -1
- data/lib/puppet/type.rb +15 -7
- data/lib/puppet/type/file.rb +40 -15
- data/lib/puppet/type/file/checksum.rb +4 -4
- data/lib/puppet/type/file/source.rb +33 -13
- data/lib/puppet/type/filebucket.rb +1 -1
- data/lib/puppet/type/notify.rb +2 -2
- data/lib/puppet/type/package.rb +16 -1
- data/lib/puppet/type/service.rb +59 -8
- data/lib/puppet/type/user.rb +19 -10
- data/lib/puppet/util.rb +41 -3
- data/lib/puppet/util/autoload.rb +10 -25
- data/lib/puppet/util/character_encoding.rb +9 -5
- data/lib/puppet/util/checksums.rb +19 -4
- data/lib/puppet/util/connection.rb +8 -8
- data/lib/puppet/util/execution.rb +2 -2
- data/lib/puppet/util/fileparsing.rb +2 -2
- data/lib/puppet/util/log/destinations.rb +1 -10
- data/lib/puppet/util/package/version/range.rb +4 -1
- data/lib/puppet/util/package/version/range/eq.rb +14 -0
- data/lib/puppet/util/provider_features.rb +1 -1
- data/lib/puppet/util/reference.rb +1 -1
- data/lib/puppet/util/run_mode.rb +5 -1
- data/lib/puppet/util/windows.rb +1 -0
- data/lib/puppet/util/windows/api_types.rb +60 -33
- data/lib/puppet/util/windows/eventlog.rb +1 -6
- data/lib/puppet/util/windows/monkey_patches/dir.rb +40 -0
- data/lib/puppet/util/windows/principal.rb +8 -6
- data/lib/puppet/util/windows/registry.rb +11 -11
- data/lib/puppet/util/windows/security.rb +4 -4
- data/lib/puppet/util/windows/service.rb +43 -26
- data/lib/puppet/util/windows/user.rb +242 -8
- data/lib/puppet/version.rb +1 -1
- data/locales/puppet.pot +541 -427
- data/man/man5/puppet.conf.5 +84 -19
- data/man/man8/puppet-agent.8 +7 -4
- data/man/man8/puppet-apply.8 +1 -1
- data/man/man8/puppet-catalog.8 +1 -1
- data/man/man8/puppet-config.8 +6 -6
- data/man/man8/puppet-describe.8 +1 -1
- data/man/man8/puppet-device.8 +1 -1
- data/man/man8/puppet-doc.8 +1 -1
- data/man/man8/puppet-epp.8 +1 -1
- data/man/man8/puppet-facts.8 +1 -1
- data/man/man8/puppet-filebucket.8 +1 -1
- data/man/man8/puppet-generate.8 +1 -1
- data/man/man8/puppet-help.8 +6 -3
- data/man/man8/puppet-key.8 +1 -1
- data/man/man8/puppet-lookup.8 +2 -2
- data/man/man8/puppet-man.8 +1 -1
- data/man/man8/puppet-module.8 +4 -1
- data/man/man8/puppet-node.8 +4 -4
- data/man/man8/puppet-parser.8 +1 -1
- data/man/man8/puppet-plugin.8 +1 -1
- data/man/man8/puppet-report.8 +1 -1
- data/man/man8/puppet-resource.8 +1 -1
- data/man/man8/puppet-script.8 +1 -1
- data/man/man8/puppet-ssl.8 +1 -1
- data/man/man8/puppet-status.8 +2 -2
- data/man/man8/puppet.8 +2 -2
- data/spec/fixtures/integration/application/apply/environments/spec/modules/amod/lib/puppet/provider/applytest/applytest.rb +2 -0
- data/spec/fixtures/integration/application/apply/environments/spec/modules/amod/lib/puppet/type/applytest.rb +25 -0
- data/spec/fixtures/unit/forge/bacula-releases.json +128 -0
- data/spec/fixtures/unit/forge/bacula.tar.gz +0 -0
- data/spec/fixtures/unit/provider/package/dnfmodule/{dnf-module-list-enabled.txt → dnf-module-list.txt} +6 -0
- data/spec/fixtures/unit/provider/package/puppetserver_gem/gem-list-local-packages +30 -0
- data/spec/fixtures/unit/provider/package/zypper/zypper-search-uninstalled.out +13 -0
- data/spec/integration/application/agent_spec.rb +202 -52
- data/spec/integration/application/apply_spec.rb +149 -149
- data/spec/integration/application/config_spec.rb +74 -0
- data/spec/integration/application/doc_spec.rb +16 -6
- data/spec/integration/application/filebucket_spec.rb +70 -21
- data/spec/integration/application/help_spec.rb +42 -0
- data/spec/integration/application/lookup_spec.rb +13 -0
- data/spec/integration/application/module_spec.rb +68 -0
- data/spec/integration/application/plugin_spec.rb +75 -2
- data/spec/integration/configurer_spec.rb +14 -0
- data/spec/integration/data_binding_spec.rb +82 -0
- data/spec/integration/defaults_spec.rb +27 -3
- data/spec/integration/directory_environments_spec.rb +17 -17
- data/spec/integration/http/client_spec.rb +6 -1
- data/spec/integration/indirector/facts/facter_spec.rb +8 -6
- data/spec/integration/network/http_pool_spec.rb +73 -0
- data/spec/integration/node/environment_spec.rb +1 -1
- data/spec/integration/parser/compiler_spec.rb +11 -0
- data/spec/integration/type/file_spec.rb +1 -1
- data/spec/integration/util/execution_spec.rb +22 -0
- data/spec/integration/util/windows/adsi_spec.rb +7 -2
- data/spec/integration/util/windows/monkey_patches/dir_spec.rb +11 -0
- data/spec/integration/util/windows/process_spec.rb +26 -32
- data/spec/integration/util/windows/registry_spec.rb +7 -7
- data/spec/integration/util/windows/user_spec.rb +47 -5
- data/spec/integration/util_spec.rb +7 -33
- data/spec/lib/puppet_spec/https.rb +6 -0
- data/spec/lib/puppet_spec/matchers.rb +0 -80
- data/spec/lib/puppet_spec/puppetserver.rb +8 -0
- data/spec/shared_contexts/types_setup.rb +2 -0
- data/spec/unit/agent_spec.rb +47 -1
- data/spec/unit/application/agent_spec.rb +7 -8
- data/spec/unit/application/doc_spec.rb +2 -2
- data/spec/unit/application/face_base_spec.rb +6 -4
- data/spec/unit/application/facts_spec.rb +41 -10
- data/spec/unit/application/man_spec.rb +52 -0
- data/spec/unit/application/resource_spec.rb +3 -1
- data/spec/unit/application/ssl_spec.rb +15 -2
- data/spec/unit/application_spec.rb +9 -4
- data/spec/unit/configurer/downloader_spec.rb +10 -0
- data/spec/unit/configurer/fact_handler_spec.rb +4 -4
- data/spec/unit/configurer_spec.rb +86 -37
- data/spec/unit/confine_spec.rb +2 -1
- data/spec/unit/context/trusted_information_spec.rb +25 -2
- data/spec/unit/daemon_spec.rb +5 -64
- data/spec/unit/environments_spec.rb +99 -32
- data/spec/unit/face/config_spec.rb +59 -1
- data/spec/unit/face/module/search_spec.rb +17 -0
- data/spec/unit/face/node_spec.rb +2 -2
- data/spec/unit/file_serving/http_metadata_spec.rb +37 -14
- data/spec/unit/file_serving/mount/locales_spec.rb +2 -2
- data/spec/unit/file_serving/mount/pluginfacts_spec.rb +2 -2
- data/spec/unit/file_serving/mount/plugins_spec.rb +2 -2
- data/spec/unit/file_serving/terminus_selector_spec.rb +45 -26
- data/spec/unit/file_system/uniquefile_spec.rb +29 -0
- data/spec/unit/file_system_spec.rb +1 -2
- data/spec/unit/http/client_spec.rb +74 -19
- data/spec/unit/http/external_client_spec.rb +9 -9
- data/spec/unit/http/resolver_spec.rb +24 -5
- data/spec/unit/http/response_spec.rb +6 -0
- data/spec/unit/http/service/ca_spec.rb +2 -3
- data/spec/unit/http/service/compiler_spec.rb +2 -3
- data/spec/unit/http/service/file_server_spec.rb +2 -3
- data/spec/unit/http/service/puppetserver_spec.rb +82 -0
- data/spec/unit/http/service/report_spec.rb +2 -3
- data/spec/unit/http/service_spec.rb +0 -1
- data/spec/unit/http/session_spec.rb +8 -21
- data/spec/unit/indirector/catalog/compiler_spec.rb +1 -0
- data/spec/unit/indirector/catalog/json_spec.rb +1 -1
- data/spec/unit/indirector/catalog/rest_spec.rb +1 -1
- data/spec/unit/indirector/facts/rest_spec.rb +1 -1
- data/spec/unit/indirector/file_metadata/http_spec.rb +194 -0
- data/spec/unit/indirector/file_metadata/rest_spec.rb +15 -14
- data/spec/unit/indirector/json_spec.rb +8 -8
- data/spec/unit/indirector/msgpack_spec.rb +8 -8
- data/spec/unit/indirector/node/rest_spec.rb +1 -1
- data/spec/unit/indirector/request_spec.rb +5 -5
- data/spec/unit/indirector/rest_spec.rb +14 -1
- data/spec/unit/indirector/status/rest_spec.rb +1 -1
- data/spec/unit/indirector/yaml_spec.rb +7 -7
- data/spec/unit/interface_spec.rb +3 -3
- data/spec/unit/module_tool/tar/mini_spec.rb +20 -0
- data/spec/unit/network/format_support_spec.rb +3 -2
- data/spec/unit/network/http/api/indirected_routes_spec.rb +2 -1
- data/spec/unit/network/http/api/master/v3/environments_spec.rb +12 -23
- data/spec/unit/network/http/connection_spec.rb +552 -190
- data/spec/unit/network/http/nocache_pool_spec.rb +22 -0
- data/spec/unit/network/http_pool_spec.rb +63 -57
- data/spec/unit/network/http_spec.rb +1 -1
- data/spec/unit/node/environment_spec.rb +18 -1
- data/spec/unit/parser/ast/block_expression_spec.rb +1 -1
- data/spec/unit/parser/environment_compiler_spec.rb +7 -0
- data/spec/unit/parser/scope_spec.rb +1 -1
- data/spec/unit/pops/evaluator/evaluating_parser_spec.rb +15 -1
- data/spec/unit/pops/loaders/loaders_spec.rb +71 -1
- data/spec/unit/pops/lookup/lookup_spec.rb +25 -0
- data/spec/unit/pops/types/type_calculator_spec.rb +1 -11
- data/spec/unit/provider/exec_spec.rb +4 -3
- data/spec/unit/provider/package/aix_spec.rb +29 -0
- data/spec/unit/provider/package/apt_spec.rb +77 -0
- data/spec/unit/provider/package/aptitude_spec.rb +1 -0
- data/spec/unit/provider/package/dnfmodule_spec.rb +25 -5
- data/spec/unit/provider/package/dpkg_spec.rb +22 -7
- data/spec/unit/provider/package/openbsd_spec.rb +2 -0
- data/spec/unit/provider/package/pip2_spec.rb +36 -0
- data/spec/unit/provider/package/pip_spec.rb +42 -16
- data/spec/unit/provider/package/portage_spec.rb +5 -0
- data/spec/unit/provider/package/puppet_gem_spec.rb +4 -1
- data/spec/unit/provider/package/puppetserver_gem_spec.rb +137 -0
- data/spec/unit/provider/package/yum_spec.rb +47 -8
- data/spec/unit/provider/package/zypper_spec.rb +98 -0
- data/spec/unit/provider/service/base_spec.rb +2 -4
- data/spec/unit/provider/service/bsd_spec.rb +5 -1
- data/spec/unit/provider/service/daemontools_spec.rb +1 -1
- data/spec/unit/provider/service/debian_spec.rb +3 -5
- data/spec/unit/provider/service/freebsd_spec.rb +1 -1
- data/spec/unit/provider/service/gentoo_spec.rb +4 -5
- data/spec/unit/provider/service/init_spec.rb +46 -5
- data/spec/unit/provider/service/launchd_spec.rb +5 -6
- data/spec/unit/provider/service/openbsd_spec.rb +9 -0
- data/spec/unit/provider/service/openrc_spec.rb +4 -5
- data/spec/unit/provider/service/openwrt_spec.rb +2 -1
- data/spec/unit/provider/service/redhat_spec.rb +10 -1
- data/spec/unit/provider/service/runit_spec.rb +2 -1
- data/spec/unit/provider/service/smf_spec.rb +1 -1
- data/spec/unit/provider/service/src_spec.rb +3 -5
- data/spec/unit/provider/service/systemd_spec.rb +87 -19
- data/spec/unit/provider/service/upstart_spec.rb +4 -5
- data/spec/unit/provider/service/windows_spec.rb +50 -14
- data/spec/unit/provider/user/openbsd_spec.rb +1 -0
- data/spec/unit/provider/user/useradd_spec.rb +30 -16
- data/spec/unit/provider/user/windows_adsi_spec.rb +82 -0
- data/spec/unit/puppet_pal_2pec.rb +40 -0
- data/spec/unit/puppet_pal_catalog_spec.rb +43 -0
- data/spec/unit/puppet_spec.rb +33 -0
- data/spec/unit/reports/http_spec.rb +1 -1
- data/spec/unit/reports/store_spec.rb +17 -13
- data/spec/unit/resource_spec.rb +3 -3
- data/spec/unit/rest/route_spec.rb +4 -4
- data/spec/unit/settings_spec.rb +182 -22
- data/spec/unit/ssl/ssl_provider_spec.rb +69 -43
- data/spec/unit/ssl/state_machine_spec.rb +52 -8
- data/spec/unit/test/test_helper_spec.rb +17 -0
- data/spec/unit/transaction/persistence_spec.rb +15 -0
- data/spec/unit/transaction/report_spec.rb +3 -1
- data/spec/unit/type/file/source_spec.rb +4 -4
- data/spec/unit/type/file_spec.rb +122 -96
- data/spec/unit/type/filebucket_spec.rb +1 -1
- data/spec/unit/type/service_spec.rb +218 -8
- data/spec/unit/type/user_spec.rb +32 -3
- data/spec/unit/type_spec.rb +50 -0
- data/spec/unit/util/autoload_spec.rb +2 -1
- data/spec/unit/util/character_encoding_spec.rb +4 -4
- data/spec/unit/util/checksums_spec.rb +16 -0
- data/spec/unit/util/command_line_spec.rb +11 -6
- data/spec/unit/util/log/destinations_spec.rb +1 -29
- data/spec/unit/util/package/version/range_spec.rb +22 -1
- data/spec/unit/util/run_mode_spec.rb +6 -6
- data/spec/unit/util/windows/api_types_spec.rb +104 -40
- data/spec/unit/util/windows/service_spec.rb +4 -4
- data/spec/unit/util_spec.rb +3 -3
- data/spec/unit/x509/cert_provider_spec.rb +1 -1
- data/tasks/manpages.rake +5 -35
- metadata +43 -49
- data/spec/integration/faces/config_spec.rb +0 -91
- data/spec/integration/faces/documentation_spec.rb +0 -57
- data/spec/integration/file_bucket/file_spec.rb +0 -50
- data/spec/integration/file_serving/content_spec.rb +0 -7
- data/spec/integration/file_serving/fileset_spec.rb +0 -12
- data/spec/integration/file_serving/metadata_spec.rb +0 -8
- data/spec/integration/file_serving/terminus_helper_spec.rb +0 -20
- data/spec/integration/file_system/uniquefile_spec.rb +0 -26
- data/spec/integration/module_tool/forge_spec.rb +0 -51
- data/spec/integration/module_tool/tar/mini_spec.rb +0 -28
- data/spec/integration/provider/service/init_spec.rb +0 -48
- data/spec/integration/provider/service/systemd_spec.rb +0 -25
- data/spec/integration/provider/service/windows_spec.rb +0 -50
- data/spec/integration/reference/providers_spec.rb +0 -21
- data/spec/integration/reports_spec.rb +0 -13
- data/spec/integration/ssl/certificate_request_spec.rb +0 -44
- data/spec/integration/ssl/host_spec.rb +0 -72
- data/spec/integration/ssl/key_spec.rb +0 -99
- data/spec/integration/test/test_helper_spec.rb +0 -31
- data/spec/shared_behaviours/file_serving_model.rb +0 -51
- data/spec/unit/face/man_spec.rb +0 -25
- data/spec/unit/man_spec.rb +0 -31
    
        data/man/man5/puppet.conf.5
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPETCONF" "5" " | 
| 4 | 
            +
            .TH "PUPPETCONF" "5" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            \fBThis page is autogenerated; any changes will get overwritten\fR
         | 
| 6 6 | 
             
            .
         | 
| 7 7 | 
             
            .SH "Configuration settings"
         | 
| @@ -149,7 +149,7 @@ The name to use the Certificate Authority certificate\. | |
| 149 149 | 
             
            The port to use for the certificate authority\.
         | 
| 150 150 | 
             
            .
         | 
| 151 151 | 
             
            .IP "\(bu" 4
         | 
| 152 | 
            -
            \fIDefault\fR: $ | 
| 152 | 
            +
            \fIDefault\fR: $serverport
         | 
| 153 153 | 
             
            .
         | 
| 154 154 | 
             
            .IP "" 0
         | 
| 155 155 | 
             
            .
         | 
| @@ -275,6 +275,9 @@ For best compatibility, you should limit the value of \fBcertname\fR to only use | |
| 275 275 | 
             
            .IP "\(bu" 4
         | 
| 276 276 | 
             
            The special value \fBca\fR is reserved, and can\'t be used as the certname for a normal node\.
         | 
| 277 277 | 
             
            .
         | 
| 278 | 
            +
            .IP
         | 
| 279 | 
            +
            \fBNote:\fR You must set the certname in the main section of the puppet\.conf file\. Setting it in a different section causes errors\.
         | 
| 280 | 
            +
            .
         | 
| 278 281 | 
             
            .IP "" 0
         | 
| 279 282 | 
             
            .
         | 
| 280 283 | 
             
            .P
         | 
| @@ -329,7 +332,7 @@ The main Puppet code directory\. The default for this setting is calculated base | |
| 329 332 | 
             
            .IP "" 0
         | 
| 330 333 | 
             
            .
         | 
| 331 334 | 
             
            .SS "color"
         | 
| 332 | 
            -
            Whether to use colors when logging to the console\. Valid values are \fBansi\fR (equivalent to \fBtrue\fR), \fBhtml\fR, and \fBfalse\fR, which produces no color\. | 
| 335 | 
            +
            Whether to use colors when logging to the console\. Valid values are \fBansi\fR (equivalent to \fBtrue\fR), \fBhtml\fR, and \fBfalse\fR, which produces no color\.
         | 
| 333 336 | 
             
            .
         | 
| 334 337 | 
             
            .IP "\(bu" 4
         | 
| 335 338 | 
             
            \fIDefault\fR: ansi
         | 
| @@ -588,30 +591,38 @@ The name of a registered environment data provider used when obtaining environme | |
| 588 591 |  | 
| 589 592 | 
             
            .
         | 
| 590 593 | 
             
            .SS "environment_timeout"
         | 
| 591 | 
            -
            How long the Puppet  | 
| 594 | 
            +
            How long the Puppet server should cache data it loads from an environment\.
         | 
| 592 595 | 
             
            .
         | 
| 593 596 | 
             
            .P
         | 
| 594 | 
            -
            A value of \fB0\fR will disable caching\. This setting can also be set to \fBunlimited\fR, which will cache environments until the  | 
| 597 | 
            +
            A value of \fB0\fR will disable caching\. This setting can also be set to \fBunlimited\fR, which will cache environments until the server is restarted or told to refresh the cache\. All other values will result in Puppet server evicting expired environments\. The expiration time is computed based on either when the environment was created or last accessed, see \fBenvironment_timeout_mode\fR\.
         | 
| 595 598 | 
             
            .
         | 
| 596 599 | 
             
            .P
         | 
| 597 | 
            -
            You should change this setting once your Puppet deployment is doing non\-trivial work\. We chose the default value of \fB0\fR because it lets new users update their code without any extra steps, but it lowers the performance of your Puppet  | 
| 600 | 
            +
            You should change this setting once your Puppet deployment is doing non\-trivial work\. We chose the default value of \fB0\fR because it lets new users update their code without any extra steps, but it lowers the performance of your Puppet server\. We recommend either:
         | 
| 598 601 | 
             
            .
         | 
| 599 | 
            -
            . | 
| 600 | 
            -
             | 
| 602 | 
            +
            .IP "\(bu" 4
         | 
| 603 | 
            +
            Setting this to \fBunlimited\fR and explicitly refreshing your Puppet server as part of your code deployment process\.
         | 
| 601 604 | 
             
            .
         | 
| 602 605 | 
             
            .IP "\(bu" 4
         | 
| 603 | 
            -
             | 
| 606 | 
            +
            Setting this to a number that will keep your most actively used environments cached, but allow testing environments to fall out of the cache and reduce memory usage\. A value of 3 minutes (3m) is a reasonable value\. This option requires setting \fBenvironment_timeout_mode\fR to \fBfrom_last_used\fR\.
         | 
| 604 607 | 
             
            .
         | 
| 605 608 | 
             
            .IP "" 0
         | 
| 606 609 | 
             
            .
         | 
| 607 610 | 
             
            .P
         | 
| 608 | 
            -
             | 
| 611 | 
            +
            Once you set \fBenvironment_timeout\fR to a non\-zero value, you need to tell Puppet server to read new code from disk using the \fBenvironment\-cache\fR API endpoint after you deploy new code\. See the docs for the Puppet Server administrative API \fIhttps://puppet\.com/docs/puppetserver/latest/admin\-api/v1/environment\-cache\.html\fR\.
         | 
| 609 612 | 
             
            .
         | 
| 610 613 | 
             
            .IP "\(bu" 4
         | 
| 611 614 | 
             
            \fIDefault\fR: 0
         | 
| 612 615 | 
             
            .
         | 
| 613 616 | 
             
            .IP "" 0
         | 
| 614 617 | 
             
            .
         | 
| 618 | 
            +
            .SS "environment_timeout_mode"
         | 
| 619 | 
            +
            How Puppet interprets the \fBenvironment_timeout\fR setting when \fBenvironment_timeout\fR is neither \fB0\fR nor \fBunlimited\fR\. If set to \fBfrom_created\fR, then the environment will be evicted \fBenvironment_timeout\fR seconds from when it was created\. If set to \fBfrom_last_used\fR then the environment will be evicted \fBenvironment_timeout\fR seconds from when it was last used\.
         | 
| 620 | 
            +
            .
         | 
| 621 | 
            +
            .IP "\(bu" 4
         | 
| 622 | 
            +
            \fIDefault\fR: from_created
         | 
| 623 | 
            +
            .
         | 
| 624 | 
            +
            .IP "" 0
         | 
| 625 | 
            +
            .
         | 
| 615 626 | 
             
            .SS "environmentpath"
         | 
| 616 627 | 
             
            A search path for directory environments, as a list of directories separated by the system path separator character\. (The POSIX path separator is \':\', and the Windows path separator is \';\'\.)
         | 
| 617 628 | 
             
            .
         | 
| @@ -794,7 +805,7 @@ The group Puppet Server will run as\. Used to ensure the agent side processes (a | |
| 794 805 | 
             
            .IP "" 0
         | 
| 795 806 | 
             
            .
         | 
| 796 807 | 
             
            .SS "hiera_config"
         | 
| 797 | 
            -
            The hiera configuration file\. Puppet only reads this file on startup, so you must restart the puppet  | 
| 808 | 
            +
            The hiera configuration file\. Puppet only reads this file on startup, so you must restart the puppet server every time you edit it\.
         | 
| 798 809 | 
             
            .
         | 
| 799 810 | 
             
            .IP "\(bu" 4
         | 
| 800 811 | 
             
            \fIDefault\fR: $confdir/hiera\.yaml\. However, for backwards compatibility, if a file exists at $codedir/hiera\.yaml, Puppet uses that instead\.
         | 
| @@ -920,7 +931,15 @@ The time to wait for data to be read from an HTTP connection\. If nothing is rea | |
| 920 931 | 
             
            The HTTP User\-Agent string to send when making network requests\.
         | 
| 921 932 | 
             
            .
         | 
| 922 933 | 
             
            .IP "\(bu" 4
         | 
| 923 | 
            -
            \fIDefault\fR: Puppet/6\. | 
| 934 | 
            +
            \fIDefault\fR: Puppet/6\.19\.0 Ruby/2\.5\.1\-p57 (x86_64\-linux)
         | 
| 935 | 
            +
            .
         | 
| 936 | 
            +
            .IP "" 0
         | 
| 937 | 
            +
            .
         | 
| 938 | 
            +
            .SS "ignore_plugin_errors"
         | 
| 939 | 
            +
            Whether the puppet run should ignore errors during pluginsync\. If the setting is false and there are errors during pluginsync, then the agent will abort the run and submit a report containing information about the failed run\.
         | 
| 940 | 
            +
            .
         | 
| 941 | 
            +
            .IP "\(bu" 4
         | 
| 942 | 
            +
            \fIDefault\fR: true
         | 
| 924 943 | 
             
            .
         | 
| 925 944 | 
             
            .IP "" 0
         | 
| 926 945 | 
             
            .
         | 
| @@ -1198,6 +1217,14 @@ The maximum amount of time the Puppet agent should wait for its certificate requ | |
| 1198 1217 | 
             
            .
         | 
| 1199 1218 | 
             
            .IP "" 0
         | 
| 1200 1219 | 
             
            .
         | 
| 1220 | 
            +
            .SS "maxwaitforlock"
         | 
| 1221 | 
            +
            The maximum amount of time the puppet agent should wait for an already running puppet agent to finish before starting a new one\. This is set by default to 1 minute\. A value of \fBunlimited\fR will cause puppet agent to wait indefinitely\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
         | 
| 1222 | 
            +
            .
         | 
| 1223 | 
            +
            .IP "\(bu" 4
         | 
| 1224 | 
            +
            \fIDefault\fR: 1m
         | 
| 1225 | 
            +
            .
         | 
| 1226 | 
            +
            .IP "" 0
         | 
| 1227 | 
            +
            .
         | 
| 1201 1228 | 
             
            .SS "merge_dependency_warnings"
         | 
| 1202 1229 | 
             
            Whether to merge class\-level dependency failure warnings\.
         | 
| 1203 1230 | 
             
            .
         | 
| @@ -1369,7 +1396,7 @@ Where puppet agent stores the password for its private key\. Generally unused\. | |
| 1369 1396 | 
             
            The shell search path\. Defaults to whatever is inherited from the parent process\.
         | 
| 1370 1397 | 
             
            .
         | 
| 1371 1398 | 
             
            .P
         | 
| 1372 | 
            -
            This setting can only be set in the \fB[main]\fR section of puppet\.conf; it cannot be set in \fB[ | 
| 1399 | 
            +
            This setting can only be set in the \fB[main]\fR section of puppet\.conf; it cannot be set in \fB[server]\fR, \fB[agent]\fR, or an environment config section\.
         | 
| 1373 1400 | 
             
            .
         | 
| 1374 1401 | 
             
            .IP "\(bu" 4
         | 
| 1375 1402 | 
             
            \fIDefault\fR: none
         | 
| @@ -1424,6 +1451,14 @@ From where to retrieve plugins\. The standard Puppet \fBfile\fR type is used for | |
| 1424 1451 | 
             
            .
         | 
| 1425 1452 | 
             
            .IP "" 0
         | 
| 1426 1453 | 
             
            .
         | 
| 1454 | 
            +
            .SS "pluginsync"
         | 
| 1455 | 
            +
            Whether plugins should be synced with the central server\. This setting is deprecated\.
         | 
| 1456 | 
            +
            .
         | 
| 1457 | 
            +
            .IP "\(bu" 4
         | 
| 1458 | 
            +
            \fIDefault\fR: true
         | 
| 1459 | 
            +
            .
         | 
| 1460 | 
            +
            .IP "" 0
         | 
| 1461 | 
            +
            .
         | 
| 1427 1462 | 
             
            .SS "postrun_command"
         | 
| 1428 1463 | 
             
            A command to run after every agent run\. If this command returns a non\-zero return code, the entire Puppet run will be considered to have failed, even though it might have performed work during the normal run\.
         | 
| 1429 1464 | 
             
            .
         | 
| @@ -1527,7 +1562,7 @@ Whether the \'http\' report processor should include the system certificate stor | |
| 1527 1562 | 
             
            The port to communicate with the report_server\.
         | 
| 1528 1563 | 
             
            .
         | 
| 1529 1564 | 
             
            .IP "\(bu" 4
         | 
| 1530 | 
            -
            \fIDefault\fR: $ | 
| 1565 | 
            +
            \fIDefault\fR: $serverport
         | 
| 1531 1566 | 
             
            .
         | 
| 1532 1567 | 
             
            .IP "" 0
         | 
| 1533 1568 | 
             
            .
         | 
| @@ -1626,7 +1661,7 @@ Where Puppet PID files are kept\. | |
| 1626 1661 | 
             
            .IP "" 0
         | 
| 1627 1662 | 
             
            .
         | 
| 1628 1663 | 
             
            .SS "runinterval"
         | 
| 1629 | 
            -
            How often puppet agent applies the catalog\. Note that a runinterval of 0 means "run continuously" rather than "never run\."  | 
| 1664 | 
            +
            How often puppet agent applies the catalog\. Note that a runinterval of 0 means "run continuously" rather than "never run\." This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
         | 
| 1630 1665 | 
             
            .
         | 
| 1631 1666 | 
             
            .IP "\(bu" 4
         | 
| 1632 1667 | 
             
            \fIDefault\fR: 30m
         | 
| @@ -1673,6 +1708,14 @@ The list of puppet master servers to which the puppet agent should connect, in t | |
| 1673 1708 | 
             
            .
         | 
| 1674 1709 | 
             
            .IP "" 0
         | 
| 1675 1710 | 
             
            .
         | 
| 1711 | 
            +
            .SS "serverport"
         | 
| 1712 | 
            +
            The default port puppet subcommands use to communicate with Puppet Server\. (eg \fBpuppet facts upload\fR, \fBpuppet agent\fR)\. May be overridden by more specific settings (see \fBca_port\fR, \fBreport_port\fR)\.
         | 
| 1713 | 
            +
            .
         | 
| 1714 | 
            +
            .IP "\(bu" 4
         | 
| 1715 | 
            +
            \fIDefault\fR: 8140
         | 
| 1716 | 
            +
            .
         | 
| 1717 | 
            +
            .IP "" 0
         | 
| 1718 | 
            +
            .
         | 
| 1676 1719 | 
             
            .SS "show_diff"
         | 
| 1677 1720 | 
             
            Whether to log and report a contextual diff when files are being replaced\. This causes partial file contents to pass through Puppet\'s normal logging and reporting system, so this setting should be used with caution if you are sending Puppet\'s reports to an insecure destination\. This feature currently requires the \fBdiff/lcs\fR Ruby library\.
         | 
| 1678 1721 | 
             
            .
         | 
| @@ -1775,6 +1818,13 @@ The setting is deprecated and has no effect\. Ensure all root and intermediate c | |
| 1775 1818 | 
             
            .TP
         | 
| 1776 1819 | 
             
            \fIDefault\fR:
         | 
| 1777 1820 |  | 
| 1821 | 
            +
            .
         | 
| 1822 | 
            +
            .SS "ssl_trust_store"
         | 
| 1823 | 
            +
            A file containing CA certificates in PEM format that puppet should trust when making HTTPS requests\. This \fBonly\fR applies to https requests to non\-puppet infrastructure, such as retrieving file metadata and content from https file sources, puppet module tool and the \'http\' report processor\. This setting is ignored when making requests to puppet:// URLs such as catalog and report requests\.
         | 
| 1824 | 
            +
            .
         | 
| 1825 | 
            +
            .TP
         | 
| 1826 | 
            +
            \fIDefault\fR:
         | 
| 1827 | 
            +
             | 
| 1778 1828 | 
             
            .
         | 
| 1779 1829 | 
             
            .SS "ssldir"
         | 
| 1780 1830 | 
             
            Where SSL certificates are kept\.
         | 
| @@ -1945,7 +1995,7 @@ Transactional storage file for persisting data between transactions for the purp | |
| 1945 1995 | 
             
            .IP "" 0
         | 
| 1946 1996 | 
             
            .
         | 
| 1947 1997 | 
             
            .SS "trusted_external_command"
         | 
| 1948 | 
            -
            The external trusted facts script to use\. This setting\'s value can be set to the path to an executable command that can produce external trusted facts\. The command must:
         | 
| 1998 | 
            +
            The external trusted facts script or directory to use\. This setting\'s value can be set to the path to an executable command that can produce external trusted facts or to a directory containing those executable commands\. The command(s) must:
         | 
| 1949 1999 | 
             
            .
         | 
| 1950 2000 | 
             
            .IP "\(bu" 4
         | 
| 1951 2001 | 
             
            Take the name of a node as a command\-line argument\.
         | 
| @@ -1956,10 +2006,14 @@ Return a JSON hash with the external trusted facts for this node\. | |
| 1956 2006 | 
             
            .IP "\(bu" 4
         | 
| 1957 2007 | 
             
            For unknown or invalid nodes, exit with a non\-zero exit code\.
         | 
| 1958 2008 | 
             
            .
         | 
| 1959 | 
            -
            .IP "\(bu" 4
         | 
| 1960 | 
            -
            \fIDefault\fR:
         | 
| 1961 | 
            -
            .
         | 
| 1962 2009 | 
             
            .IP "" 0
         | 
| 2010 | 
            +
            .
         | 
| 2011 | 
            +
            .P
         | 
| 2012 | 
            +
            If the setting points to an executable command, then the external trusted facts will be stored in the \'external\' key of the trusted facts hash\. Otherwise for each executable file in the directory, the external trusted facts will be stored in the \fB<basename>\fR key of the \fBtrusted[\'external\']\fR hash\. For example, if the files foo\.rb and bar\.sh are in the directory, then \fBtrusted[\'external\']\fR will be the hash \fB{ \'foo\' => <foo\.rb output>, \'bar\' => <bar\.sh output> }\fR\.
         | 
| 2013 | 
            +
            .
         | 
| 2014 | 
            +
            .TP
         | 
| 2015 | 
            +
            \fIDefault\fR:
         | 
| 2016 | 
            +
             | 
| 1963 2017 | 
             
            .
         | 
| 1964 2018 | 
             
            .SS "trusted_oid_mapping_file"
         | 
| 1965 2019 | 
             
            File that provides mapping between custom SSL oids and user\-friendly names
         | 
| @@ -2039,6 +2093,17 @@ Puppet agent cannot apply configurations until its approved certificate is avail | |
| 2039 2093 | 
             
            .
         | 
| 2040 2094 | 
             
            .IP "" 0
         | 
| 2041 2095 | 
             
            .
         | 
| 2096 | 
            +
            .SS "waitforlock"
         | 
| 2097 | 
            +
            How frequently puppet agent should try running when there is an already ongoing puppet agent instance\.
         | 
| 2098 | 
            +
            .
         | 
| 2099 | 
            +
            .P
         | 
| 2100 | 
            +
            This argument is by default disabled (value set to 0)\. In this case puppet agent will immediately exit if it cannot run at that moment\. When a value other than 0 is set, this can also be used in combination with the \fBmaxwaitforlock\fR argument\. This setting can be a time interval in seconds (30 or 30s), minutes (30m), hours (6h), days (2d), or years (5y)\.
         | 
| 2101 | 
            +
            .
         | 
| 2102 | 
            +
            .IP "\(bu" 4
         | 
| 2103 | 
            +
            \fIDefault\fR: 0
         | 
| 2104 | 
            +
            .
         | 
| 2105 | 
            +
            .IP "" 0
         | 
| 2106 | 
            +
            .
         | 
| 2042 2107 | 
             
            .SS "yamldir"
         | 
| 2043 2108 | 
             
            The directory in which YAML data is stored, usually in a subdirectory\.
         | 
| 2044 2109 | 
             
            .
         | 
    
        data/man/man8/puppet-agent.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-AGENT" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-AGENT" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-agent\fR \- The puppet agent daemon
         | 
| @@ -13,7 +13,7 @@ Retrieves the client configuration from the Puppet master and applies it to the | |
| 13 13 | 
             
            This service may be run as a daemon, run periodically using cron (or something similar), or run interactively for testing purposes\.
         | 
| 14 14 | 
             
            .
         | 
| 15 15 | 
             
            .SH "USAGE"
         | 
| 16 | 
            -
            puppet agent [\-\-certname \fINAME\fR] [\-D|\-\-daemonize|\-\-no\-daemonize] [\-d|\-\-debug] [\-\-detailed\-exitcodes] [\-\-digest \fIDIGEST\fR] [\-\-disable [MESSAGE]] [\-\-enable] [\-\-fingerprint] [\-h|\-\-help] [\-l|\-\-logdest syslog|eventlog|\fIABS FILEPATH\fR|console] [\-\- | 
| 16 | 
            +
            puppet agent [\-\-certname \fINAME\fR] [\-D|\-\-daemonize|\-\-no\-daemonize] [\-d|\-\-debug] [\-\-detailed\-exitcodes] [\-\-digest \fIDIGEST\fR] [\-\-disable [MESSAGE]] [\-\-enable] [\-\-fingerprint] [\-h|\-\-help] [\-l|\-\-logdest syslog|eventlog|\fIABS FILEPATH\fR|console] [\-\-serverport \fIPORT\fR] [\-\-noop] [\-o|\-\-onetime] [\-\-sourceaddress \fIIP_ADDRESS\fR] [\-t|\-\-test] [\-v|\-\-verbose] [\-V|\-\-version] [\-w|\-\-waitforcert \fISECONDS\fR]
         | 
| 17 17 | 
             
            .
         | 
| 18 18 | 
             
            .SH "DESCRIPTION"
         | 
| 19 19 | 
             
            This is the main puppet client\. Its job is to retrieve the local machine\'s configuration from a remote server and apply it\. In order to successfully communicate with the remote server, the client must have a certificate signed by a certificate authority that the server trusts; the recommended method for this, at the moment, is to run a certificate authority as part of the puppet server (which is the default)\. The client will connect and request a signed certificate, and will continue connecting until it receives one\.
         | 
| @@ -123,7 +123,7 @@ Disable can also take an optional message that will be reported by the \'puppet | |
| 123 123 | 
             
            \-\-help: Print this help message
         | 
| 124 124 | 
             
            .
         | 
| 125 125 | 
             
            .IP "\(bu" 4
         | 
| 126 | 
            -
            \-\-job\-id: Attach the specified job id to the catalog request and the report used for this agent run\. This option only works when \'\-\-onetime\' is used\.
         | 
| 126 | 
            +
            \-\-job\-id: Attach the specified job id to the catalog request and the report used for this agent run\. This option only works when \'\-\-onetime\' is used\. When using Puppet Enterprise this flag should not be used as the orchestrator sets the job\-id for you and it must be unique\.
         | 
| 127 127 | 
             
            .
         | 
| 128 128 | 
             
            .IP "\(bu" 4
         | 
| 129 129 | 
             
            \-\-logdest: Where to send log messages\. Choose between \'syslog\' (the POSIX syslog service), \'eventlog\' (the Windows Event Log), \'console\', or the path to a log file\. If debugging or verbosity is enabled, this defaults to \'console\'\. Otherwise, it defaults to \'syslog\' on POSIX systems and \'eventlog\' on Windows\.
         | 
| @@ -135,7 +135,7 @@ A path ending with \'\.json\' will receive structured output in JSON format\. Th | |
| 135 135 | 
             
            A path ending with \'\.jsonl\' will receive structured output in JSON Lines format\.
         | 
| 136 136 | 
             
            .
         | 
| 137 137 | 
             
            .IP "\(bu" 4
         | 
| 138 | 
            -
            \-\-masterport: The port on which to contact the  | 
| 138 | 
            +
            \-\-masterport: The port on which to contact the Puppet Server\. (This is a Puppet setting, and can go in puppet\.conf\. Deprecated in favor of the \'serverport\' setting\.)
         | 
| 139 139 | 
             
            .
         | 
| 140 140 | 
             
            .IP "\(bu" 4
         | 
| 141 141 | 
             
            \-\-noop: Use \'noop\' mode where the daemon runs in a no\-op or dry\-run mode\. This is useful for seeing what changes Puppet would make without actually executing the changes\. (This is a Puppet setting, and can go in puppet\.conf\. Note the special \'no\-\' prefix for boolean settings on the command line\.)
         | 
| @@ -144,6 +144,9 @@ A path ending with \'\.jsonl\' will receive structured output in JSON Lines form | |
| 144 144 | 
             
            \-\-onetime: Run the configuration once\. Runs a single (normally daemonized) Puppet run\. Useful for interactively running puppet agent when used in conjunction with the \-\-no\-daemonize option\. (This is a Puppet setting, and can go in puppet\.conf\. Note the special \'no\-\' prefix for boolean settings on the command line\.)
         | 
| 145 145 | 
             
            .
         | 
| 146 146 | 
             
            .IP "\(bu" 4
         | 
| 147 | 
            +
            \-\-serverport: The port on which to contact the Puppet Server\. (This is a Puppet setting, and can go in puppet\.conf\.)
         | 
| 148 | 
            +
            .
         | 
| 149 | 
            +
            .IP "\(bu" 4
         | 
| 147 150 | 
             
            \-\-sourceaddress: Set the source IP address for transactions\. This defaults to automatically selected\. (This is a Puppet setting, and can go in puppet\.conf\.)
         | 
| 148 151 | 
             
            .
         | 
| 149 152 | 
             
            .IP "\(bu" 4
         | 
    
        data/man/man8/puppet-apply.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-APPLY" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-APPLY" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-apply\fR \- Apply Puppet manifests locally
         | 
    
        data/man/man8/puppet-catalog.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-CATALOG" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-CATALOG" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-catalog\fR \- Compile, save, view, and convert catalogs\.
         | 
    
        data/man/man8/puppet-config.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-CONFIG" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-CONFIG" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-config\fR \- Interact with Puppet\'s settings\.
         | 
| @@ -35,7 +35,7 @@ Whether to log debug information\. | |
| 35 35 | 
             
            The section of the puppet\.conf configuration file to interact with\.
         | 
| 36 36 | 
             
            .
         | 
| 37 37 | 
             
            .IP
         | 
| 38 | 
            -
            The three most commonly used sections are \'main\', \' | 
| 38 | 
            +
            The three most commonly used sections are \'main\', \'server\', and \'agent\'\. \'Main\' is the default, and is used by all Puppet applications\. Other sections can override \'main\' values for specific applications \-\-\- the \'server\' section affects Puppet Server, and the \'agent\' section affects puppet agent\.
         | 
| 39 39 | 
             
            .
         | 
| 40 40 | 
             
            .IP
         | 
| 41 41 | 
             
            Less commonly used is the \'user\' section, which affects puppet apply\. Any other section will be treated as the name of a legacy environment (a deprecated feature), and can only include the \'manifest\' and \'modulepath\' settings\.
         | 
| @@ -112,10 +112,10 @@ Delete the setting \'setting_name\' from the \'main\' configuration domain: | |
| 112 112 | 
             
            $ puppet config delete setting_name
         | 
| 113 113 | 
             
            .
         | 
| 114 114 | 
             
            .P
         | 
| 115 | 
            -
            Delete the setting \'setting_name\' from the \' | 
| 115 | 
            +
            Delete the setting \'setting_name\' from the \'server\' configuration domain:
         | 
| 116 116 | 
             
            .
         | 
| 117 117 | 
             
            .P
         | 
| 118 | 
            -
            $ puppet config delete setting_name \-\-section  | 
| 118 | 
            +
            $ puppet config delete setting_name \-\-section server
         | 
| 119 119 | 
             
            .
         | 
| 120 120 | 
             
            .P
         | 
| 121 121 | 
             
            \fBprint\fR
         | 
| @@ -127,10 +127,10 @@ Get puppet\'s runfile directory: | |
| 127 127 | 
             
            $ puppet config print rundir
         | 
| 128 128 | 
             
            .
         | 
| 129 129 | 
             
            .P
         | 
| 130 | 
            -
            Get a list of important directories from the  | 
| 130 | 
            +
            Get a list of important directories from the server\'s config:
         | 
| 131 131 | 
             
            .
         | 
| 132 132 | 
             
            .P
         | 
| 133 | 
            -
            $ puppet config print all \-\-section  | 
| 133 | 
            +
            $ puppet config print all \-\-section server | grep \-E "(path|dir)"
         | 
| 134 134 | 
             
            .
         | 
| 135 135 | 
             
            .P
         | 
| 136 136 | 
             
            \fBset\fR
         | 
    
        data/man/man8/puppet-describe.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-DESCRIBE" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-DESCRIBE" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-describe\fR \- Display help about resource types
         | 
    
        data/man/man8/puppet-device.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-DEVICE" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-DEVICE" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-device\fR \- Manage remote network devices
         | 
    
        data/man/man8/puppet-doc.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-DOC" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-DOC" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-doc\fR \- Generate Puppet references
         | 
    
        data/man/man8/puppet-epp.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-EPP" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-EPP" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-epp\fR \- Interact directly with the EPP template parser/renderer\.
         | 
    
        data/man/man8/puppet-facts.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-FACTS" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-FACTS" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-facts\fR \- Retrieve and store facts\.
         | 
| @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-FILEBUCKET" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-FILEBUCKET" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-filebucket\fR \- Store and retrieve files in a filebucket
         | 
    
        data/man/man8/puppet-generate.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-GENERATE" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-GENERATE" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-generate\fR \- Generates Puppet code from Ruby definitions\.
         | 
    
        data/man/man8/puppet-help.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-HELP" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-HELP" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-help\fR \- Display Puppet help\.
         | 
| @@ -34,7 +34,7 @@ Whether to log debug information\. | |
| 34 34 | 
             
            \fBSYNOPSIS\fR
         | 
| 35 35 | 
             
            .
         | 
| 36 36 | 
             
            .IP
         | 
| 37 | 
            -
            puppet help [\-\-version VERSION] [\fIsubcommand\fR] [\fIaction\fR]
         | 
| 37 | 
            +
            puppet help [\-\-version VERSION] [\-\-ronn] [\fIsubcommand\fR] [\fIaction\fR]
         | 
| 38 38 | 
             
            .
         | 
| 39 39 | 
             
            .IP
         | 
| 40 40 | 
             
            \fBDESCRIPTION\fR
         | 
| @@ -43,7 +43,10 @@ puppet help [\-\-version VERSION] [\fIsubcommand\fR] [\fIaction\fR] | |
| 43 43 | 
             
            Display help about Puppet subcommands and their actions\.
         | 
| 44 44 | 
             
            .
         | 
| 45 45 | 
             
            .IP
         | 
| 46 | 
            -
            \fBOPTIONS\fR \fI\-\- | 
| 46 | 
            +
            \fBOPTIONS\fR \fI\-\-ronn\fR \- Whether to render the help text in ronn format\.
         | 
| 47 | 
            +
            .
         | 
| 48 | 
            +
            .IP
         | 
| 49 | 
            +
            \fI\-\-version VERSION\fR \- The version of the subcommand for which to show help\.
         | 
| 47 50 | 
             
            .
         | 
| 48 51 | 
             
            .IP
         | 
| 49 52 | 
             
            \fBRETURNS\fR
         | 
    
        data/man/man8/puppet-key.8
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "PUPPET\-KEY" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-KEY" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 7 | 
             
            \fBpuppet\-key\fR \- Create, save, and remove certificate keys\.
         | 
    
        data/man/man8/puppet-lookup.8
    CHANGED
    
    | @@ -1,10 +1,10 @@ | |
| 1 1 | 
             
            .\" generated with Ronn/v0.7.3
         | 
| 2 2 | 
             
            .\" http://github.com/rtomayko/ronn/tree/0.7.3
         | 
| 3 3 | 
             
            .
         | 
| 4 | 
            -
            .TH "LOOKUP" "8" " | 
| 4 | 
            +
            .TH "PUPPET\-LOOKUP" "8" "October 2020" "Puppet, Inc." "Puppet manual"
         | 
| 5 5 | 
             
            .
         | 
| 6 6 | 
             
            .SH "NAME"
         | 
| 7 | 
            -
            \ | 
| 7 | 
            +
            \fBpuppet\-lookup\fR \- Interactive Hiera lookup
         | 
| 8 8 | 
             
            .
         | 
| 9 9 | 
             
            .SH "SYNOPSIS"
         | 
| 10 10 | 
             
            Does Hiera lookups from the command line\.
         |