Included in Puppet Enterprise 2017.1. A newer version is available; see the version menu above for details.
The following Puppet settings are deprecated and will be removed in Puppet 5.0.
Puppet Server 2.2 and newer use a new, HOCON-based
auth.conf file, which is a full replacement for the old
auth.conf format. Support for the old file will be removed in Puppet 5.0 (and the Puppet Server version that supports it). Puppet Server’s old
client-whitelist settings for the
/puppet-admin-api endpoints will be removed at the same time.
- The new
auth.conffile is located at
- The old
auth.conffile is located at
Authorization rules in
fileserver.conf let you specify authorization rules for the file server on a per-mountpoint basis. After authorization was centralized, this was redundant; all authorization rules should go in
auth.conf (new style).
In Puppet 5.0 and the Puppet Server version that supports it, “allow” and “deny” rules in
fileserver.conf will not be allowed.
cfacter setting was used to enable pre-releases of native Facter (distributed as the “cfacter” package) prior to the release of Facter 3.0. Now that native Facter is the default in
puppet-agent packages, this setting has no purpose.
configtimeout setting mashed the connect and read timeouts together, which could cause erroneous timeouts if everything was working fine but Puppet was transferring a very large file.
It has been replaced by two new settings:
http_connect_timeout— controls how long Puppet should attempt to make a connection. A short timeout for this is sensible, since an over-long connect time usually means something’s wrong.
http_read_timeout— controls how long Puppet should allow transfers to continue. It’s normal to let this last a long time or be infinite, since some things just take a while to compile or download.
configtimeout setting now logs a deprecation warning if it’s set, and will be removed in Puppet 5.0.
When automatic class parameter lookup was still young, we included the option to replace Hiera with an alternate data backend, using the
But data binding termini were a really hairy extension point, and Hiera 5’s improved custom backend system makes them unnecessary. Setting
data_binding_terminus to anything but
hiera is now deprecated, and the setting will be removed in Puppet 6.
- If you’re using a custom
data_binding_terminus, rewrite it as a custom Hiera 5 backend. You’re already an advanced Puppet hacker if you managed to build one of these in the first place, so you can probably write an equivalent Hiera 5 backend in an afternoon or two. We hope you enjoy this improved interface!
- If you were disabling automatic class parameter lookup (
data_binding_terminus = none), you can’t do that anymore. Module authors are relying on it for default data these days.
ignorecache setting has no effect, and has been dead code since Puppet 0.24.5.
This setting does not log a deprecation warning. Once it is removed in Puppet 5.0, Puppet will fail to start if you pass
--ignorecache as a command line argument.
For all practical purposes,
pluginsync = true (the default value) is mandatory for all Puppet users. If pluginsync is disabled, it becomes difficult or impossible to use custom facts, custom resource types, and custom providers, all of which are crucial parts of the Puppet ecosystem.
Since disabling it is catastrophic and has no particular benefit, we plan to remove the option to do so in Puppet 5.0.