Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
1459 lines (896 sloc) 89.4 KB
layout title description canonical
Puppet 3.0 — 3.4 Release Notes
Puppet release notes for version 3.0 through 3.4

[3047]: "Cron entries using "special" parameter lose their title when changed" [5752]: "Solaris 10 root crontab gets destroyed" [16121]: "Cron user change results in duplicate entries on target user" [16809]: "cron resource can destroy other resources" [19716]: "cron job not sucked into puppet" [19876]: "Regression: cron now matches on-disk records too aggressively" [11276]: "Get puppet module tool working on Windows" [13542]: "PMT cannot install tarballs for modules that don't exist on the Forge" [14728]: "puppet module changes incorrectly errors when a file is missing" [18229]: "Eroneous command given in puppet module error message" [19128]: ""puppet module build" doesn't escape PSON correctly" [19409]: "puppet module errors from Puppet::Forge don't obey render mode" [15841]: "Consider bundling minitar (or equivalent) for use by puppet module face" [7680]: "Checksum missmatch when copying followed symlinks" [14544]: "The apply application should support writing the resources file and classes file" [14766]: "2nd puppet run after restart is ignoring runinterval, negating splay" [18211]: "puppet agent sleeping well past runinterval" [14985]: "calling_module and calling_class don't always return the calling module/class" [17474]: "Indirector treats false from a terminus as nil"

This page documents the history of the Puppet 3 series.

Starting from version 3.0.0, Puppet is semantically versioned with a three-part version number. In version X.Y.Z:

  • X must increase for major backwards-incompatible changes.
  • Y may increase for backwards-compatible new functionality.
  • Z may increase for bug fixes.

Note: In general, you should upgrade the puppet master servers before upgrading the agents they support.

Also, before upgrading, look above at the table of contents for this page. Identify the version you're upgrading TO and any versions you're upgrading THROUGH, and check them for a subheader labeled "Upgrade Warning," which will always be at the top of that version's notes. If there's anything special you need to know before upgrading, we will put it here.

Puppet 3.4.3

Released February 19, 2014.

3.4.3 is a bug fix release in the Puppet 3.4 series.

Bug Fixes

PUP-1473: User resource fails on UTF-8 comment

Puppet's user resource now supports UTF-8 characters for the comment attribute, rather than just ASCII.

PUP-736: Encoding mis-matches cause package prefetching to fail

Previously, puppet could fail to process a package resource if it referred to an RPM whose description contained non-ASCII characters. Puppet now handles these resources correctly.

PUP-1524: Duplicate events since 3.4.0

Since Puppet 3.4.0, failed resources would sometimes be logged twice. These duplicate events were particularly problematic for PuppetDB, since they could cause the whole transaction to be rolled back. This release fixes the issue.

PUP-1485: test agent/fallback_to_cached_catalog.rb assumes no master is running by default

The acceptance test for falling back to a cached catalog would still run with a puppet master, even though the functionality assumed that the puppet master was unavailable. The test now guarantees that the master will be unreachable by specifying a bogus server.

PUP-1322: Puppet REST API always fails if there's at least one broken manifest

Previously, REST API calls to <host>/production/resource_types/*?kind=class would fail completely if there was a syntax error in one or more manifests in the module path. This release changes that behavior so that the call will succeed and list all parseable classes.

PUP-1529: Usability regression caused by PUP-1322

Fixes a regression caused by the fix for PUP-1322: syntax errors reached while loading an include would be squelched, which would eventually result in a misleading "class not found" error.

PUP-751: Performance regression due to excessive file watching

This performance regression was also linked to PUP-1322: excessive file watching was causing a significant slowdown during catalog compilation. This release addresses the performance hit and improves benchmarking by adding tasks to measure the loading of defined types.

PUP-1729: Remove Debian Sid from build targets

Acceptance testing on Debian Sid (unstable) was failing regularly due to factors outside of our control, like broken packages in the distribution's own repositories. Acceptance tests are still being run against the Debian "testing" release.

Windows-Specific Fixes

PUP-1211: Puppet Resource Package fails

On Windows, the puppet resource package command would fail immediately if at least one of the installed packages had non-ASCII characters in its display name. Puppet will now use the correct string encoding on Windows, which fixes this bug.

PUP-1389: Windows File resources generating 0 byte files when title has "-"

This bug prevented puppet from properly managing the content of file resources with "-" in their titles on Windows. This release fixes the bug.

PUP-1411: Windows agents experience intermittent SSL_connect failures in acceptance testing

Acceptance tests would intermittently fail on Windows due to a bug involving OpenSSL and WEBrick that would cause the connection to time out after 6.2 seconds. This release improves the OpenSSL initialization process and extends the timeout interval to 10 seconds, which fixes the bug.

Puppet 3.4.2

Released January 6, 2014.

3.4.2 is a bug fix release in the Puppet 3.4 series.

Bug Fixes

PUP-724: Could not autoload puppet /util /instrumentation /listeners /log"

This bug could cause a failure while autoloading puppet/util/instrumentation/listeners/log.rb. It was related to the way that puppet compared Ruby Time instances, which would sometimes differ when they shouldn't.

PUP-1015: Could not intialize global default settings...

This regression was introduced in Puppet 3.4.0 and prevented Foreman from functioning properly.

PUP-1099: Incorrect permissions in RPMs

This caused some example file permissions to be set incorrectly on RHEL6.

PUP-1144: No longer allows variables with leading underscores

This caused the the experimental future parser to reject variable names that started with $_. It was introduced in Puppet 3.4.0.

PUP-1255: Default file mode is now 0600 instead of 0644

The default mode for file resources was changed from 0644 to 0600 in Puppet 3.4.1. This release restores the previous behavior.

Puppet 3.4.1

Released December 26, 2013.

3.4.1 is a security fix release of the Puppet 3.4 series. It has no other bug fixes or new features.

Security Fixes

CVE-2013-4969 (Unsafe use of temp files in file type)

Previous code used temp files unsafely by looking for a name it could use in a directory, and then later writing to that file. This created a vulnerability in which an attacker could make the name a symlink to another file and thereby cause puppet agent to overwrite something it did not intend to.

Puppet 3.4.0

Released December 19, 2013. (RC1: Dec. 3. RC2: Dec. 10.)

3.4.0 is a backward-compatible feature and fix release in the Puppet 3 series. The main improvements of this release are:

  • Fixes for some high-profile bugs, including the "anchor pattern" issue and broken RDoc on Ruby 1.9+
  • New certificate autosigning behavior to help quickly and securely add new nodes in elastic environments
  • Windows improvements, especially for file resources
  • Trusted node data in the compiler

It introduces one known regression, PUP-1015, for users who use Foreman's provisioning tools. If you use Foreman for provisioning, you should wait and upgrade to 3.4.2.

New contain Function Removes Need for "Anchor Pattern"

Puppet now includes a contain function to allow classes to contain other classes. It works similarly to the include function, with the added effect of creating a containment relationship. For more information, see:

(Issue 8040, PUP-99)

Policy-Based Certificate Autosigning

Puppet can now use site-specific logic to decide which certificate signing requests (CSRs) should be autosigned. This feature is based on custom executables, which can examine each CSR as it arrives and use any decision-making criteria you choose.

Prior to 3.4, Puppet would accept a whitelist of nodes whose requests should be autosigned. This wasn't very flexible, and didn't allow things like using a preshared key to verify the legitimacy of a node. This is now very possible, and works especially well when combined with the next new feature (custom CSR attributes).

For details, see:

(Issue 7244, PUP-664, PUP-453)

Custom Data in CSRs and Certificates

It is now possible for puppet agent nodes to insert arbitrary data into their certificate signing requests (CSRs). This data can be used as verification for policy-based autosigning (see above), and may have more applications in the future.

Two kinds of custom data are available: "custom attributes," which are discarded once the certificate is signed, and "certificate extensions," which persist in the signed certificate.

For details on custom CSR data, see:

(Issue 7243, PUP-669, PUP-670, PUP-664)

Priority Level Can Be Set for Puppet Processes

Puppet's processes, including puppet agent and puppet apply, can now lower or raise their own priority level using the priority setting. (Note that they can't raise their priority unless they are running as a privileged user.)

This is especially useful for making sure resource-intensive Puppet runs don't interfere with a machine's real duties.

(Issue 21241, PUP-39)

Manifest Documentation (RDoc/Puppetdoc) Works on Ruby 1.9+

Puppet manifests can be documented with RDoc-formatted text in comments above each class or defined type, and you can run puppet doc --outputdir /tmp/rdoc to extract that documentation and generate HTML with it. However, this has never worked when running Puppet under Ruby 1.9 or higher.

As of this release, building documentation sites with puppet doc works under Ruby 1.9 and 2.0.

Note that any existing problems with the puppet doc command still apply --- it sometimes skips certain classes with no clear reason, and there are various formatting glitches. We are still investigating more reliable and convenient ways to display Puppet code documentation, and will probably be using Geppetto as a foundation for future efforts.

(Issue 22180, PUP-568)

New $trusted Hash With Trusted Node Data

Since at least Puppet 2.6, the Puppet compiler receives a special $clientcert variable that contains the node's certificate name. However, this variable is self-reported by agent nodes and is not verified by the puppet master. This means $clientcert might contain more or less anything, and can't be trusted when deciding whether to insert sensitive information into the catalog.

As of 3.4, you can configure the puppet master to verify each agent node's certname and make it available to the compiler as $trusted['certname']. To do this, you must set the trusted_node_data setting to true in the master's puppet.conf. See the language documentation about special variables for more details.

(Issue 19514, PUP-122)

File Resources Can Opt Out of Source Permissions

Traditionally, if file resources did not have the owner, group, and/or mode permissions explicitly specified and were using a source file, they would set the permissions on the target system to match those of the source. This could cause files to be insecure or too secure on Windows systems being managed by a Linux puppet master. (And even in all-*nix environments, it often isn't the desired behavior.)

Now, you can opt out of source permissions using the file type's source_permissions attribute. This can be done per-resource, or globally with a resource default in site.pp.

As part of this, the previous default behavior (source_permissions => use) is now deprecated on Windows; the default for Windows is expected to change to ignore in Puppet 4.0.

(Issue 5240, Issue 18931)

Windows Improvements

Puppet's Windows support continues to get better, with improvements to resource types and packaging.

File Type Improvements

Package Type Improvements

Group Type Improvements

Exec Type Improvements

  • Puppet will now accurately capture exit codes from exec resources on Windows. (Previously, exit codes higher than 255 were mangled: Puppet would report modulo 255 of the actual exit code, such that exit code 257 would appear as 2.) (Issue 23124, PUP-434)

Packaging and Installer Improvements

  • The Windows Puppet installer has several new MSI properties for automated installation, which can set the service user and startup mode. (Issue 21243, Issue 18268, PUP-386, PUP-387)
  • The Windows installer now puts Puppet on the PATH, so a special command prompt is no longer necessary. (Issue 22700, PUP-415)
  • Windows installer options can now override existing settings. (Issue 20281, PUP-388)

New puppet cert reinventory Command

As part of the fix for issue 693/23074, the Puppet CA no longer rebuilds the certificate inventory for each new certificate.

However, rebuilding the inventory can still be helpful, generally when you have a large inventory file with a high percentage of old revoked certificates. When necessary, it can now be done manually by running puppet cert reinventory when your puppet master is stopped.

(Issue 23074, PUP-637)

RPM Package Provider Now Supports install_options

Package resources using the rpm package provider can now specify command-line flags to pass to the RPM binary. This is generally useful for specifying a --prefix, or for overriding macros like arch.

(Issue 22642, PUP-444)

HTTP API Documentation

Puppet's HTTP API endpoints now have extensive documentation for the formatting of their requests and the objects they return. For version-specific endpoint documentation, see the HTTP API section of the developer docs.

(PUP-124, PUP-125, PUP-126, PUP-127, PUP-128, PUP-131, PUP-133, PUP-134, PUP-135, PUP-136, PUP-137, PUP-138, PUP-139)

Msgpack Serialization (Experimental)

Puppet agents and masters can now optionally use Msgpack for all communications. This is an experimental feature and is disabled by default; see the Msgpack experiment page for details about it.

(Issue 22849, PUP-472)

Changes to Experimental Future Parser

Several changes were made to the experimental lambda and iteration support included in the future parser. The documentation has been updated to reflect the changes; see the "Experimental Features" section in the navigation sidebar to the left.

Preparations for Syncing External Facts

Puppet can now pluginsync external facts to agent nodes... but it's not very useful yet, since Facter can't yet load those facts. End-to-end support is planned for next quarter, in Facter 2.0.

(Issue 9546, PUP-578)

Miscellaneous Improvements

  • Allow profiling on puppet apply. Previously, the profiling features added for Puppet 3.2 were only available to puppet agent; now, puppet apply can log profiling information when run with --profile or profile = true in puppet.conf. (Issue 22581, PUP-341)
  • Mount resources now autorequire parent mounts. (Issue 22665, PUP-450)
  • Class main now appears in containment paths in reports. Previously, it was represented by an empty string, which could be confusing. This is mostly useful for PuppetDB. (Issue 23131, PUP-278)
  • Puppet::Util.execute now offers a way to get the exit status of the command --- the object it returns, which was previously a String containing the command's output, is now a subclass of String with an #exitstatus method that returns the exit status. This can be useful for type and provider developers. (Issue 2538)

Bug Fixes

Fixed Race Condition in Certificate Serial Numbers

As part of improving certificate autosigning for elastic cloud environments, we found a series of bugs involving the certificate inventory --- when too many certificates were being signed at once (impossible in manual signing, but easy when testing autosigning at large scales), the CA might assign a serial number to a node, start rebuilding the inventory, then assign the same number to another node (if it came in before the rebuild was finished).

This is now fixed, and the cert inventory is handled more safely. To accommodate the need to occasionally rebuild the inventory, a puppet cert reinventory command was added (see above).

(Issue 693, Issue 23074, PUP-277, PUP-635, PUP-636, PUP-637)

Cached Catalogs Work Again

This was a regression from Puppet 3.0.0, as an unintended consequence of making the ENC authoritative for node environments. In many cases (generally when agents couldn't reach the puppet master), it broke the puppet agent's ability to use cached catalogs when it failed to retrieve one. The issue is now fixed, and agents will obey the usecacheonfailure setting.

(Issue 22925, PUP-580)

Hiera Bugs

  • Errors from automatic class parameter lookups were not clearly indicating that Hiera was the source of the problem. This was made more informative. (Issue 19955, PUP-176)
  • Automatic class parameter lookups weren't setting the special calling_module / calling_class variables. This has been fixed. (Issue 21198, PUP-83)

Misc Bug Fixes

The usual grab bag of clean-ups and fixes. As of 3.4.0, Puppet will:

  • Manage the vardir's owner and group. Before, not managing the vardir's owner and group could sometimes cause the puppet master or CA tools to fail, if the ownership of the vardir got messed up. (PUP-319)
  • Don't overaggressively use resource-like class evaluation for ENCs that assign classes with the hash syntax. ENCs can use two methods for assigning classes to nodes, one of which allows class parameters to be specified. If class parameters ARE specified, the class has to be evaluated like a resource to prevent parameter conflicts. This fixed the problem that Puppet was being a little overeager and wasn't checking whether parameters were actually present. (Issue 23096, PUP-268)
  • Make Puppet init scripts report run status correctly even if they aren't configured to start. Previously, if the puppet master init script was configured to never run and a Puppet manifest was also ensuring the service was stopped, this could cause Puppet to try to stop the service every single run. (Issue 23033, PUP-642)
  • Skip module metadata that cannot be parsed. Previously, module metadata that couldn't be parsed was not skipped and could cause the puppet master to fail catalog serving if a module with bad metadata was installed. (Issue 22818, Issue 20728, Issue 15856, PUP-614)
  • Use FFI native windows root certs code. This fix cleaned up some potential puppet agent crashes on Windows by using the Win32 APIs better. (Issue 23183, PUP-766)
  • Guard against duplicate Windows root certs. Previously, duplicates could cause unnecessary run failures. (Issue 21817, PUP-734)
  • Make Debian user/group resources report their proper containment path. Previously, Puppet events from Debian showed in Puppet Enterprise's event inspector as "unclassified." (Issue 22943, PUP-565)
  • Fix race condition in filebucket. Before the fix, there were unnecessary run failures when multiple nodes were trying to write to a puppet master's filebucket. (Issue 22918, PUP-538)
  • Force encoding of user comment values to ASCII-8BIT. Previously, there were run failures under Ruby 1.9 and higher when user resources were present. (Issue 22703, PUP-451)
  • Don't serialize transient vars in Puppet::Resource. Previously, Puppet would write YAML data that couldn't be deserialized by other tools. (Issue 4506, PUP-447)
  • Validate the name attribute for package resources to disallow arrays. Previously, there was inconsistent behavior between dpkg and the other package providers. (Issue 22557, PUP-403)
  • Use the most preferred supported serialization format over HTTP. Puppet had been choosing a format at random whenever there were multiple acceptable formats. (Issue 22891, PUP-570)
  • Set value_collection for boolean params. Before the fix, boolean resource attributes were displayed badly in the type reference. (Issue 22699, PUP-446)

All 3.4.0 Changes

For a list of all changes in the 3.4.0 release, see:

Puppet 3.3.2

Released November 12, 2013

3.3.2 is a bug fix release in the Puppet 3.3 series. The most important fix was a bug causing problems with NetApp devices.

Bug Fixes

Issue 22804: NetApp network device failing with Puppet >3.2.1 - "Could not intern..."

This caused failures when using the puppet device subcommand with NetApp network devices. It could also cause failures with any custom functions, types, or providers that used the Ruby REXML library to do heavy lifting, if they happened to call include REXML outside any module or class.

Issue 22810: RPM provider query method returns leading quote in package names

This was causing strange interactions with MCollective when querying packages on RPM-based systems.

Issue 22847: Windows Puppet::Util::ADSI::User and Puppet::Util::ADSI::Group issues WMI queries that hang Puppet in a domain environment

When getting a list of existing user accounts on a Windows machine, Puppet was putting out a query that could seem to take forever in a large ActiveDirectory environment. It was fixed by limiting the query to the local objects that Puppet actually cares about.

Issue 22878: Running processes on windows (through mcollective) cause private CloseHandle to be called instead of public method

This didn't affect most users, due to the way Puppet is packaged on Windows, but it could cause major failures of many resource types for people running Puppet from source.

Puppet 3.3.1

Released October 7, 2013.

3.3.1 is a bug fix release in the Puppet 3.3 series. The focus of the release is fixing backwards compatibility regressions that slipped in via the YAML deprecations in 3.3.0.

Upgrade Note

The release of Puppet 3.3.1 supersedes the upgrade warning for Puppet 3.3.0. As of this release, agent nodes are compatible with all Puppet 3.x masters with no extra configuration.

Fixes for Backwards Compatibility Regressions in 3.3.0

New backward compatibility issues were discovered after the release of 3.3.0, so we changed our handling of deprecated wire formats.

Starting with 3.3.1, you do not need to set additional settings in puppet.conf on your agent nodes in order to use newer agents with puppet masters running 3.2.4 or earlier. Agents will work with all 3.x masters, and they will automatically negotiate wire formats as needed. This behavior supersedes the behavior described for 3.3.0; the report_serialization_format setting is now unnecessary.

Additionally, this release fixes:

  • Two cases where 3.3.0 masters would do the wrong thing with older agents. (Reports would fail unless the master had report_serialization_format set to yaml, which was not intended, and remote filebucket backups would always fail.)
  • A regression where files that should have been ignored during pluginsync were being copied to agents.

Miscellaneous Regression Fixes

Issue 22772: Managing an empty file causes a filebucket error

This was a regression in 3.3.0, caused by deprecating YAML for content we send to remote filebuckets.

Issue 22384: Excessive logging for files not found

This was a regression in 3.3.0.

When using multiple values in an array for the file type's source attribute, Puppet will check them in order and use the first one it finds; whenever it doesn't find one, it will log a note at the "info" log level, which is silent when logging isn't verbose. In 3.3.0, the level was accidentally changed to the "notice" level, which was too noisy.

Issue 22529: apt package ensure absent/purged causes warnings on 3.3.0

This was a regression in 3.3.0. The apt package provider was logging bogus warnings when processing resources with ensure values of absent or purged.

Issue 22493: Can't start puppet agent on non english Windows

This problem was probably introduced in Puppet 3.2, when our Windows installer switched to Ruby 1.9; a fix was attempted in 3.2.4, but it wasn't fully successful.

The behavior was caused by a bug in one of the Ruby libraries Puppet relies on. We submitted a fix upstream, and packaged a fixed version of the gem into the Windows installer.

Fixes for Long-Standing Bugs

Issue 19994: ParsedFile providers do not clear failed flush operations from their queues

This bug dates to Puppet 2.6 or earlier.

The bug behavior was weird. Basically:

  • Your manifests include multiple ssh_authorized_key resources for multiple user accounts.
  • One of the users has messed-up permissions for their authorized keys file, and their resource fails because Puppet tries to write to the file as that user.
  • All remaining key resources also fail, because Puppet tries to write the rest of them to that same user's file instead of the file they were supposed to go in.

Issue 21975: Puppet Monkey patch 'def instance_variables' clashing with SOAP Class...

This bug dates to 3.0.0. It was causing problems when using plugins that use SOAP libraries, such as the types and providers in the puppetlabs/f5 module.

Issue 22474: --no-zlib flag doesn't prevent zlib from being required in Puppet

This bug dates to 3.0.0, and caused Puppet to fail when running on a copy of Ruby without zlib compiled in.

Issue 22471: Malformed state.yaml causes puppet to fail runs with Psych yaml parser

This bug dates to 3.0.0, and could cause occasional agent run failures under Ruby 1.9 or 2.0.

Puppet 3.3.0

Released September 12, 2013.

3.3.0 is a backward-compatible feature and fix release in the Puppet 3 series.

Upgrade Warning (Superseded by Puppet 3.3.1)

Note: The following is superseded by compatibility improvements in Puppet 3.3.1, which requires no configuration to work with older masters. If possible, you should upgrade directly to 3.3.1 instead of 3.3.0.

Although 3.3.0 is backward-compatible, its default configuration will cause reporting failures when ≥ 3.3.0 agent nodes connect to a sub-3.3.0 master.

  • This only affects newer agents + older masters; it is not a problem if you upgrade the puppet master first.
  • To use ≥ 3.3.0 agents with an older puppet master, set report_serialization_format to yaml in their puppet.conf files; this restores full compatibility.

See the note below on yaml deprecation for details.

Configurable Resource Ordering

(Issue 22205: Order of resource application should be selectable by a setting.)

Puppet can now optionally apply unrelated resources in the order they were written in their manifest files.

A new ordering setting configures how unrelated resources should be ordered when applying a catalog. This setting affects puppet agent and puppet apply, but not puppet master.

The allowed values for this setting are title-hash, manifest, and random:

  • title-hash (the default) will order resources randomly, but will use the same order across runs and across nodes.
  • manifest will use the order in which the resources were declared in their manifest files.
  • random will order resources randomly and change their order with each run. This can work like a fuzzer for shaking out undeclared dependencies.

Regardless of this setting's value, Puppet will always obey explicit dependencies set with the before/require/notify/subscribe metaparameters and the ->/~> chaining arrows; this setting only affects the relative ordering of unrelated resources.

Data in Modules

(Issue 16856: puppet should support data in modules)

This feature makes it possible to contribute data bindings from modules to a site-wide hierarchy of data bindings. This feature is introduced as an opt-in, and it is turned on by setting binder to true in puppet.conf. It is turned on by default when using the future parser. The implementation is based on ARM-9 Data in Modules, which contains the background, a description, and a set of examples.

Security: YAML Over the Network is Now Deprecated

(Issue 21427: Deprecate YAML for network data transmission)

YAML has been the cause of many security problems, so we are refactoring Puppet to stop sending YAML over the network. Puppet will still write YAML to disk (since that doesn't add security risks), but all data objects sent over the network will be serialized as JSON. (Or, for the time being, as "PSON," which is JSON that may sometimes contain non-UTF8 data.)

As of this release:

  • All places where the puppet master accepts YAML are deprecated. If the master receives YAML, it will still accept it but will log a deprecation warning.
  • The puppet master can now accept reports in JSON format. (Prior to 3.3.0, puppet masters could only accept reports in YAML.)
  • The puppet agent no longer defaults to requesting YAML from the puppet master (for catalogs, node objects, etc.).
  • The puppet agent no longer defaults to sending YAML to the puppet master (for reports, query parameters like facts, etc.).

Deprecation plan: Currently, we plan to remove YAML over the network in Puppet 4.0. This means in cases where Puppet 3.3 would issue a deprecation warning, Puppet 4 will completely refuse the request.

New Setting for Compatibility With Sub-3.3.0 Masters

Note: The following is superseded by compatibility improvements in Puppet 3.3.1, which requires no configuration to work with older masters. If possible, you should upgrade directly to 3.3.1 instead of 3.3.0.

Puppet 3.3 agents now default to sending reports as JSON, and masters running Puppet 3.2.4 and earlier cannot understand JSON reports. Using an out of the box 3.3 agent with a 3.2 puppet master will therefore fail.

  • To avoid errors, upgrade the puppet master first.
  • If you must use ≥ 3.3.0 agents with older puppet masters, set the new report_serialization_format to yaml in the agents' puppet.conf; this restores full compatibility.

Regex Capture Variables from Node Definitions ($1, etc.)

(Issue 2628: It would be useful if node name regexps set $1)

Node definitions now set the standard regex capture variables, similar to the behavior of conditional statements that use regexes.

Redirect Response Handling

(Issue 18255: accept 301 response from fileserver)

Puppet's HTTP client now follows HTTP redirects when given status codes 301 (permanent), 302 (temporary), or 307 (temporary). The new functionality includes a redirection limit, and recreates the redirected connection with the same certificates and store as the original (as long as the new location is ssl protected). Redirects are performed for GET, HEAD, and POST requests.

This is mostly useful for configuring the puppet master's front end webserver to send fileserver traffic to the closest server.

Filebucket Improvements

(Issue 22375: File bucket and Puppet File resource: fails with "regexp buffer overflow" when backing up binary file)

There were a number of problems with the remote filebucket functionality for backing up files under Puppet's management over the network. It is now possible to back up binary files, which previously would consume lots of memory and error out. Non-binary filebucket operations should also be faster as we eliminated an unnecessary network round-trip that echoed the entire contents of the file back to the agent after it was uploaded to the server.

Internal Format and API Improvements

Report Format 4

Puppet's report format version has been bumped to 4. This is backward-compatible with report format 3, and adds transaction_uuid to reports and containment_path to resource statuses.

Unique Per-run Identifier in Reports and Catalog Requests

(Issue 21831: Generate a UUID for catalog retrieval and report posts)

Puppet agent now embeds a per-run UUID in its catalog requests, and embeds the same UUID in its reports after applying the catalog. This makes it possible to correlate events from reports with the catalog that provoked those events.

There is currently no interface for doing this correlation, but a future version of PuppetDB will provide this functionality via catalog and report queries.

Readable Attributes on Puppet::ModuleTool::Dependency Objects

(Issue 21749: Make attributes readable on Puppet::ModuleTool::Dependency objects)

This API change enables access to module dependency information via Ruby code.

User Interface Improvements

Improved CSS for Puppet Doc Rdoc Output

(Issue 6561: Better looking CSS for puppet doc rdoc mode)

The standard skin for rdoc generated from Puppet manifests has been updated to improve readability. Note that puppet doc rdoc functionality remains broken on Ruby 1.9 and up.

Improved Display of Arrays in Console Output

(Issue 20284: Output one item per line for arrays in console output)

This changes the output to console from faces applications to output array items as one item per line.

Configurable Module Skeleton Directory

(Issue 21170: enhancement of the module generate functionality)

Previously, you could provide your own template for the puppet module generate action by creating a directory called skeleton in the directory specified by the module_working_dir setting. (The layout of the directory should match that of lib/puppet/module_tool/skeleton.) This directory can now be configured independently with the module_skeleton_dir setting.

Improvements to Resource Types

Package Type: Multi-Package Removal With Urpmi Provider

(Issue 16792: permit to remove more than 1 package using urpmi provider)

It was tedious to remove some packages when using the urpmi provider since it only allowed to remove one package at the time, and that removal must be made in dependency order. Now, the urpmi provider behaves similar to the apt provider.

Package Type: Package Descriptions in RAL

(Issue 19875: Get package descriptions from RAL)

Previously, rpm and dpkg provider implementations obtained package information from the system without capturing descriptions. They now capture the single line description summary for packages as a read-only parameter.

Package Type: OpenBSD Improvements

Jasper Lievisse Adriaanse contributed several improvements and fixes to the OpenBSD package provider.

(Issue 21930: Enchance OpenBSD pkg.conf handling)

It is now possible to use += when defining the installpath for OpenBSD. Previously, an attempt to use this was ignored; now, it's possible to have a pkg.conf like:

installpath = foo
installpath += bar

Which will be turned into a PKG_PATH: foo:bar.

(Issue 22021: Implement (un)install options feature for OpenBSD package provider)

It is now possible to specify install_options and uninstall_options for the OpenBSD package provider. These were previously not available.

(Issue 22023: Implement purgeable feature for OpenBSD package provider)

It is now possible to use the purged value for ensure with the OpenBSD package provider.

Yumrepo Type: AWS S3 Repos

(Issue 21452: Add s3_enabled option to the yumrepo type)

It is now possible to use a yum repo stored in AWS S3 (via the yum-s3-iam plugin) by setting the resource's s3_enabled attribute to 1.

Special thanks to 3.3.0 Contributors

Adrien Thebo, Alex Dreyer, Alexander Fortin, Alexey Lapitsky, Aman Gupta, Andrew Parker, Andy Brody, Anton Lofgren, Brice Figureau, Charlie Sharpsteen, Chris Price, Clay Caviness, David Schmitt, Dean Wilson, Duncan Phillips, Dustin J. Mitchell, Eric Sorenson, Erik Dalén, Felix Frank, Garrett Honeycutt, Henrik Lindberg, Hunter Haugen, Jasper Lievisse Adriaanse, Jeff McCune, Jeff Weiss, Jesse Hathaway, John Julien, Josh Cooper, Josh Partlow, Juan Ignacio Donoso, Kosh, Kylo Ginsberg, Mathieu Parent, Matthaus Owens, Melissa Stone, Melissa, Michael Scherer, Michal Růžička, Moses Mendoza, Neil Hemingway, Nick Fagerlund, Nick Lewis, Patrick Carlisle, Pieter van de Bruggen, Richard Clamp, Richard Pijnenburg, Richard Soderberg, Richard Stevenson, Sergey Sudakovich, Stefan Schulte, Thomas Hallgren, W. Andrew Loe III, arnoudj, floatingatoll, ironpinguin, joshrivers, phinze, superseb

All 3.3.0 Changes

See here for a list of all changes in the 3.3.0 release.

Puppet 3.2.4

Released August 15, 2013.

3.2.4 is a security fix release of the Puppet 3.2 series. It has no other bug fixes or new features.

Security Fixes

CVE-2013-4761 (resource_type Remote Code Execution Vulnerability)

By using the resource_type service, an attacker could cause Puppet to load arbitrary Ruby files from the puppet master server's file system. While this behavior is not enabled by default, auth.conf settings could be modified to allow it. The exploit requires local file system access to the Puppet Master.

CVE-2013-4956 (Puppet Module Permissions Vulnerability)

The puppet module subcommand did not correctly control permissions of modules it installed, instead transferring permissions that existed when the module was built.

Puppet 3.2.3

Released July 15, 2013.

3.2.3 is a bugfix release of the Puppet 3.2 series. It fixes some Windows bugs introduced in 3.2.0, as well as a few performance problems and miscellaneous bugs.

Windows Fixes

This release fixes several Windows bugs that couldn't be targeted for earlier 3.2 releases.

Logging and Reporting Fixes

Performance Fixes

Misc Fixes

All 3.2.3 Changes

See here for a list of all changes in the 3.2.3 release.

Puppet 3.2.2

3.2.2 is a security fix release of the Puppet 3.2 series. It has no other bug fixes or new features.

Security Fix

CVE-2013-3567 Unauthenticated Remote Code Execution Vulnerability.

A critical vulnerability was found in puppet wherein it was possible for the puppet master to take YAML from an untrusted client via the REST API. This YAML could be deserialized to construct an object containing arbitrary code.

Puppet 3.2.1

3.2.1 is a bugfix release of the Puppet 3.2 series. It addresses two major issues that were uncovered in 3.2.0 and caused us to pull that release (#20726 and #20742). It also includes a fix for Solaris support (#19760).

Issues fixed:

  • Bug #19760: install sun packages failed with: Error: /Stage[main]/Inf_sol10defaultpkg/Package[SMCcurl]: Could not evaluate: Unable to get information about package SMCcurl because of: No message
  • Bug #20726: usermod command arguments out of order
  • Bug #20742: unauthenticated clients unable to communicate with puppet master (running in passenger)

Known Regressions

On Windows, Puppet 3.2.1 is unable to manage the home directory for a user account. (Bug #20768) This is a regression from Puppet 3.1.1; it was introduced by switching to Ruby 1.9 in the Windows .msi package. This bug will be fixed soon in a point release, but wasn't severe enough to delay shipping.

All 3.2.1 Changes

See here for a list of all changes in the 3.2.1 release.

Puppet 3.2.0

3.2.0 is a backward-compatible features and fixes release in the Puppet 3 series. It was never officially released, as major bugs were discovered after the release was tagged but before it was published; 3.2.1 was the first official Puppet 3.2 release.

The most notable changes are:

  • An optional, experimental "Future" parser
  • Ruby 2.0 support
  • OpenWRT OS support
  • External CA support
  • A new modulo (%) operator
  • New slow catalog profiling capabilities
  • General improvements and fixes, including improved splay behavior, fixes to the cron type, improvements to the module tool, and some Hiera-related fixes

Ruby Bug Warning: Ruby 1.9.3-p0 has bugs that cause a number of known issues with Puppet 3.2.0 and later, and you should use a different release. To the best of our knowledge, these issues were fixed in the second public release of Ruby 1.9.3 (p125), and we are positive they are resolved in p392 (which ships with Fedora 18).

Unfortunately, Ubuntu Precise ships with p0 for some reason. The official Puppet Labs packages default to pulling in Ruby 1.8.7, but will use 1.9.3-p0 if you previously chose the system 1.9.3 package. There's not a lot we can do about the resulting bugs; if you're using Precise and want to use Ruby 1.9.3, we recommend using Puppet Enterprise or installing a third-party Ruby package.

Experimental "Future" Parser With Iteration

In a first for Puppet, we're shipping two versions of the Puppet language in one release.

By default, Puppet 3.2 is backward compatible with Puppet 3.1, with only minimal new language features (the modulo operator). However, if you set parser = future in puppet.conf, you can try out new, proposed language features like iteration (as defined in arm-2). See the documents linked above for complete details.

Note that features in the experimental parser are exempt from semantic versioning. They might change several times before being released in the "current" parser.

(Issues 19983 and 11331)

Ruby 2.0 Support

Special thanks to: Dominic Cleal.

Previous releases almost worked on Ruby 2.0; this one officially works.

(Issue 18494)

OpenWRT OS Support

Special thanks to: Kyle Anderson.

OpenWRT is a distribution of Linux that runs on small consumer-grade routers, and you can now manage more of it with Puppet. This requires Facter 1.7.0-rc1 or later, as well as Puppet 3.2. Puppet Labs doesn't ship any packages for OpenWRT.

New OpenWRT support includes:

  • Facter values:
    • operatingsystem and osfamily will report as OpenWrt
    • operatingsystemrelease will resolve correctly, by checking the /etc/openwrt_version file
    • General Linux facts will generally resolve as expected.
  • Packages:
    • The new opkg provider can install packages and dependencies from the system repositories (set in /etc/opkg.conf), can ensure specific package versions, and can install packages from files.
  • Services:
    • The new openwrt provider can enable/disable services on startup, as well as ensuring started/stopped states. Since OpenWRT init scripts don't have status commands, it uses the system process table to detect status; if a service's process name doesn't match the init script name, be sure to specify a status or pattern attribute in your resources.

(Issue 19877)

External CA Support

Special thanks to: Dustin Mitchell.

We now officially support using an external certificate authority with Puppet. See the documentation linked above for complete details.

If you were stalled on 2.7.17 due to bug 15561, upgrading to 3.2 should fix your problems.

(Issues 15561, 17864, 19271, and 20027)

Modulo Operator

Special thanks to: Erik Dalén.

The new % modulo operator will return the remainder of dividing two values.

(Issue 18950)

Better Profiling and Debugging of Slow Catalog Compilations

Special thanks to: Andy Parker and Chris Price.

If you set the profile setting to true in an agent node's puppet.conf (or specify --profile on the command line), the puppet master will log additional debug-level messages about how much time each step of its catalog compilation takes.

If you're trying to profile, be sure to check the --logdest and --debug command-line options on the master --- debug must be on, and messages will go to the log destination, which defaults to syslog. If you're running via Passenger or another Rack server, these options must be set as command-line arguments in the file and not as settings in puppet.conf.

To find the messages, look for the string PROFILE in the master's logs --- each catalog request will get a unique ID, so you can tell which messages are for which request. Ensure syslog is configured to record messages logged at debug priority when used as the log destination.

(Issue 17190)

General Improvements and Fixes

Splay Fixes for Puppet Agent

The splay setting promised relief from thundering-herd problems, but it was broken; the agents would splay on their first run, then they'd all sync up on their second run. That's fixed now.

(Issues [14766][] and [18211][])

Cron Fixes

Special thanks to: Felix Frank, Stefan Schulte, and Charlie Sharpsteen.

The cron resource type is now much better behaved, and some truly ancient bugs are fixed.

(Issues 593, 656, 1453, 2251, [3047][], [5752][], [16121][], [16809][], [19716][], and [19876][])

Module Tool Improvements

The puppet module command no longer misbehaves on systems without GNU tar installed, and it works on Windows now.

(Issues [11276][], [13542][], [14728][], [18229][], [19128][], [19409][], and [15841][])

Hiera-Related Fixes

The calling_module and calling_class pseudo-variables were broken, and automatic parameter lookup would die when it found false values. These bugs are both fixed.

(Issues [14985][] and [17474][])

puppet:/// URIs Pointing to Symlinks Work Now

Special thanks to: Chris Boot.

In older versions, a source => puppet:///..... URI pointing to a symlink on the puppet master would fail annoyingly. Now Puppet follows the symlink and serves the linked content.

(Issue [7680][])

Puppet Apply Writes Data Files Now

Special thanks to: R.I. Pienaar.

Puppet apply now writes the classes file and resources file. If you run a masterless Puppet site, you can now integrate with systems like MCollective that use these files.

(Issue [14544][])

All 3.2.0 Changes

See here for a list of all non-trivial changes for the 3.2.0 release.

Puppet 3.1.1

Puppet 3.1.1 is a security release addressing several vulnerabilities discovered in the 3.x line of Puppet. These vulnerabilities have been assigned Mitre CVE numbers CVE-2013-1640, CVE-2013-1652, CVE-2013-1653, CVE-2013-1654, CVE-2013-1655 and CVE-2013-2275.

All users of Puppet 3.1.0 and earlier are strongly encouraged to upgrade to 3.1.1.

Puppet 3.1.1 Downloads

See the Verifying Puppet Download section at:

Please report feedback via the Puppet Labs Redmine site, using an affected puppet version of 3.1.1:

Puppet 3.1.1 Changelog

  • Andrew Parker (3):

    • (#14093) Cleanup tests for template functionality
    • (#14093) Remove unsafe attributes from TemplateWrapper
    • (#14093) Restore access to the filename in the template
  • Jeff McCune (2):

    • (#19151) Reject SSLv2 SSL handshakes and ciphers
    • (#19531) (CVE-2013-2275) Only allow report save from the node matching the certname
  • Josh Cooper (7):

    • Fix module tool acceptance test
    • Run openssl from windows when trying to downgrade master
    • Remove unnecessary rubygems require
    • Don't assume puppetbindir is defined
    • Display SSL messages so we can match our regex
    • Don't require openssl client to return 0 on failure
    • Don't assume master supports SSLv2
  • Justin Stoller (6):

    • Acceptance tests for CVEs 2013 (1640, 1652, 1653, 1654,2274, 2275)
    • Separate tests for same CVEs into separate files
    • We can ( and should ) use grep instead of grep -E
    • add quotes around paths for windows interop
    • remove tests that do not run on 3.1+
    • run curl against the master on the master
  • Moses Mendoza (1):

    • Update PUPPETVERSION for 3.1.1
  • Nick Lewis (3):

    • (#19393) Safely load YAML from the network
    • Always read request body when using Rack
    • Fix order-dependent test failure in network/authorization_spec
  • Patrick Carlisle (3):

    • (#19391) (CVE-2013-1652) Disallow use_node compiler parameter for remote requests
    • (#19392) (CVE-2013-1653) Validate instances passed to indirector
    • (#19392) Don't validate key for certificate_status
  • Pieter van de Bruggen (1):

    • Updating module tool acceptance tests with new expectations.

Puppet 3.1.0

Puppet 3.1.0 is a features and fixes release in the 3.x series, focused on adding documentation and cleaning up extension loading.

New: YARD API Documentation

To go along with the improved usability of Puppet as a library, we've added YARD documentation throughout the codebase. YARD generates browsable code documentation based on in-line comments. This is a first pass through the codebase but about half of it's covered now. To use the YARD docs, simply run gem install yard then yard server --nocache from inside a puppet source code checkout (the directory containing lib/puppet). YARD documentation is also available in the generated references section under Developer Documentation.

Fix: YAML Node Cache Restored on Master

In 3.0.0, we inadvertently removed functionality that people relied upon to get a list of all the nodes checking into a particular puppet master. This is now enabled for good, added to the test harness, and available for use as:

# shell snippet
export CLIENTYAML=`puppet master --configprint yamldir`
puppet node search "*" --node_terminus yaml --clientyamldir $CLIENTYAML

Improvements When Loading Ruby Code

A major area of focus for this release was loading extension code. As people wrote and distributed Faces (new puppet subcommands that extend Puppet's capabilities), bugs like #7316 started biting them. Additionally, seemingly simple things like retrieving configuration file settings quickly got complicated, causing problems both for Puppet Labs' code like Cloud Provisioner as well as third-party integrations like Foreman. The upshot is that it's now possible to fully initialize puppet when using it as a library, loading Ruby code from Forge modules works correctly, and tools like puppetlabs_spec_helper now work correctly.

All Bugs Fixed in 3.1.0

Use the Puppet issue tracker to find every bug fixed in a given version of Puppet.

Puppet 3.0.2

3.0.2 Target version and resolved issues:

Puppet 3.0.1

3.0.1 Target version and resolved issues:

Puppet 3.0.0

Puppet 3.0.0 is the first release of the Puppet 3 series, which includes breaking changes, new features, and bug fixes.

Upgrade Warning: Many Breaking Changes

Puppet 3.0.0 is a release on a major version boundary, which means it contains breaking changes that make it incompatible with Puppet 2.7.x. These changes are listed below, and their headers begin with a "BREAK" label. You should read through them and determine which will apply to your installation.

Improved Version Numbering

Puppet 3 marks the beginning of a new version scheme for Puppet releases. Beginning with 3.0.0, Puppet uses a strict three-field version number:

  • The leftmost segment of the version number must increase for major backwards-incompatible changes.
  • The middle segment may increase for backwards-compatible new functionality.
  • The rightmost segment may increase for bug fixes.

BREAK: Changes to Dependencies and Supported Systems

  • Puppet 3 adds support for Ruby 1.9.3, and drops support for Ruby 1.8.5. (Puppet Labs is publishing Ruby 1.8.7 packages in its repositories to help users who are still on RHEL and CentOS 5.)
    • Note that puppet doc is only supported on Ruby 1.8.7, due to 1.9's changes to the underlying RDoc library. See ticket # 11786 for more information.
  • [Hiera][] is now a dependency of Puppet.
  • Puppet now requires Facter 1.6.2 or later.
  • Support for Mac OS X 10.4 has been dropped.

BREAK: Dynamic Scope for Variables is Removed

Dynamic scoping of variables, which was deprecated in Puppet 2.7, has been removed. See Language: Scope for more details. The most recent 2.7 release logs warnings about any variables in your code that are still being looked up dynamically.

Upgrade note: Before upgrading from Puppet 2.x, you should do the following:

  • Restart your puppet master --- this is necessary because deprecation warnings are only produced once per run, and warnings that were already logged may not appear again in your logs until a restart.
  • Allow all of your nodes to check in and retrieve a catalog.
  • Examine your puppet master's logs for dynamic scope warnings.
  • Edit any manifests referenced in the warnings to remove the dynamic lookup behavior. Use fully qualified variable names where necessary, and move makeshift data hierarchies out of your manifests and into [Hiera][].

BREAK: Parameters In Definitions Must Be Variables

Parameter lists in class and defined type definitions must include a dollar sign ($) prefix for each parameter. In other words, parameters must be styled like variables. Non-variable-like parameter lists have been deprecated since at least Puppet 0.23.0.

The syntax for class and defined resource declarations is unchanged.


define vhost ($port = 80, $vhostdir) { ... }


define vhost (port = 80, vhostdir) { ... }


vhost {'':
  port     => 8080,
  vhostdir => '/etc/apache2/conf.d',

BREAK: puppet:/// URLs Pointing to Module Files Must Contain modules/

Since 0.25, Puppet URLs pointing to source files in the files directory of a module have had to start with puppet:///modules/; however, the old way has continued to work (while logging deprecation warnings), ostensibly for compatibility with 0.24 clients.

Support for 0.24-style URLs has now been removed, and the modules/ portion is mandatory.

BREAK: Deprecated Commands Are Removed

The legacy standalone executables, which were replaced by subcommands in Puppet 2.6, have been removed. Additionally, running puppet without a subcommand no longer defaults to puppet apply.

Pre-2.6 Post-2.6
puppetmasterd puppet master
puppetd puppet agent
puppet puppet apply
puppetca puppet cert
ralsh puppet resource
puppetrun puppet kick
puppetqd puppet queue
filebucket puppet filebucket
puppetdoc puppet doc
pi puppet describe

Upgrade note: Examine your Puppet init scripts, the configuration of the puppet master's web server, and any wrapper scripts you may be using, and ensure that they are using the new subcommands instead of the legacy standalone commands.

BREAK: Puppet Apply's --apply Option Is Removed

The --apply option has been removed. It was replaced by --catalog.

BREAK (Partially Reverted in 3.0.2): Console Output Formatting Changes

The format of messages displayed to the console has changed slightly, potentially leading to scripts that watch these messages breaking. Additionally, we now use STDERR appropriately on *nix platforms.

Upgrade Note: If you scrape Puppet's console output, revise the relevant scripts. Note that some of these changes were reverted in 3.0.2.

This does not change the formatting of messages logged through other channels (eg: syslog, files), which remain as they were before. See bug #13559 for details

BREAK: Removed and Modified Settings

The following settings have been removed:

  • factsync (Deprecated since Puppet 0.25 and replaced with pluginsync; see ticket #2277)
  • ca_days (Replaced with ca_ttl)
  • servertype (No longer needed, due to removal of built-in Mongrel support)
  • downcasefact (Long-since deprecated)
  • reportserver (Long-since deprecated; replaced with report_server)

The following settings now behave differently:

  • pluginsync is now enabled by default
  • cacrl can no longer be set to false. Instead, Puppet will now ignore the CRL if the file in this setting is not present on disk.

BREAK: Puppet Master Rack Configuration Is Changed

Puppet master's file has changed slightly; see ext/rack/files/ in the Puppet source code for an updated example. The new configuration:

  • Should now require 'puppet/util/command_line' instead of 'puppet/application/master'.
  • Should now run instead of Puppet::Application[:master].run.
  • Should explicitly set the --confdir option (to avoid reading from ~/.puppet/puppet.conf).
    diff --git a/ext/rack/files/ b/ext/rack/files/
    index f9c492d..c825d22 100644
    --- a/ext/rack/files/
    +++ b/ext/rack/files/
    @@ -10,7 +10,25 @@ $0 = "master"
     # ARGV << "--debug"

     ARGV << "--rack"
    +ARGV << "--confdir" << "/etc/puppet"
    +ARGV << "--vardir" << "/var/lib/puppet"
    -require 'puppet/application/master'
    +require 'puppet/util/command_line'

    -run Puppet::Application[:master].run

Upgrade note: If you run puppet master via a Rack server like Passenger, you must change the file as described above.

BREAK: Special-Case Mongrel Support Is Removed; Use Rack Instead

Previously, the puppet master had special-case support for running under Mongrel. Since Puppet's standard Rack support can also be used with Mongrel, this redundant code has been removed.

Upgrade note: If you are using Mongrel to run your puppet master, re-configure it to run Puppet as a standard Rack application.

BREAK: File Type Changes

  • The recurse parameter can no longer set recursion depth, and must be set to true, false, or remote. Use the recurselimit parameter to set recursion depth. (Setting depth with the recurse parameter has been deprecated since at least Puppet 2.6.8.)

BREAK: Mount Type Changes

  • The path parameter has been removed. It was deprecated and replaced by name sometime before Puppet 0.25.0.

BREAK: Package Type Changes

  • The type parameter has been removed. It was deprecated and replaced by provider some time before Puppet 0.25.0.
  • The msi provider has been deprecated in favor of the more versatile windows provider.
  • The install_options parameter for Windows packages now accepts an array of mixed strings and hashes; however, it remains backwards-compatible with the 2.7 single hash format.
  • A new uninstall_options parameter was added for Windows packages. It uses the same semantics as install_options.

BREAK: Exec Type Changes

  • The logoutput parameter now defaults to on_failure.
  • Due to misleading values, the HOME and USER environment variables are now unset when running commands.

BREAK: Deprecated check Metaparameter Is Removed

  • The check metaparameter has been removed. It was deprecated and replaced by audit in Puppet 2.6.0.

BREAK: Puppet Agent Now Requires node Access in Master's auth.conf

Puppet agent nodes now requires access to their own node object on the puppet master; this is used for making ENC-set environments authoritative over agent-set environments. Your puppet master's auth.conf file must contain the following stanza, or else agent nodes will not be able to retrieve catalogs:

# allow nodes to retrieve their own node object
path ~ ^/node/([^/]+)$
method find
allow $1

Auth.conf has allowed this by default since 2.7.0, but puppet masters which have been upgraded from previous versions may still be disallowing it.

Upgrade note: Check your auth.conf file and make sure it includes the above stanza before the final stanza. Add it if necessary.

BREAK: auth no in auth.conf Is Now the Same as `auth any'

Previously, auth no in auth.conf would reject connections with valid certificates. This was confusing, and the behavior has been removed; auth no now allows any kind of connection, same as auth any.

BREAK: auth.conf's allow Directive Rejects IP Addresses; Use allow_ip Instead

To allow hosts based on IP address, use the new allow_ip directive. It functions exactly like IP addresses in allow used to, except that it does not support backreferences. The allow directive now assumes that the string is not an IP address.

Upgrade Note: If your auth.conf allowed any specific nodes by IP address, you must replace those allow directives with allow_ip.

BREAK: fileserver.conf Cannot Control Access By IP; Use auth.conf Instead

The above fix to ambiguous ACLs in auth.conf caused authorization by IP address in fileserver.conf to break. We are opting not to fix it, in favor of centralizing our authorization interfaces.

All authorization rules in fileserver.conf can be reproduced in auth.conf instead, as access must pass through auth.conf before reaching fileserver.conf. If you need to control access to custom fileserver mount points by IP address, set the rule in fileserver.conf to allow *, and create rules in auth.conf like the following:

path ~ ^/file_(metadata|content)s?/my_custom_mount_point/
auth yes
allow /^(.+\.)?$/

Rules like these must go above the rule for /file/. Note that you must control both the file_metadata(s) and file_content(s) paths; the regular expression above should do the trick.

BREAK: "Resource Type" API Has Changed

The API for querying resource types has changed to more closely match standard Puppet terminology. This is most likely to be visible to any external tools that were using the HTTP API to query for information about resource types.

  • You can now add a kind option to your request, which will allow you to filter results by one of the following kinds of resource types: class, node, defined_type.
  • The API would previously return a field called type for each result; this has been changed to kind.
  • The API would previously return the value hostclass for the type field for classes; this has been changed to class.
  • The API would previously return the value definition for the type field for classes; this has been changed to defined_type.
  • The API would previously return a field called arguments for any result that contained a parameter list; this has been changed to parameters.

An example of the new output:

    "line": 1,
    "file": "/home/cprice/work/puppet/test/master/conf/modules/resource_type_foo/manifests/init.pp",
    "name": "resource_type_foo",
    "kind": "class"
    "line": 1,
    "file": "/home/cprice/work/puppet/test/master/conf/modules/resource_type_foo/manifests/my_parameterized_class.pp",
    "parameters": {
      "param1": null,
      "param2": "\"default2\""
    "name": "resource_type_foo::my_parameterized_class",
    "kind": "class"
    "line": 1,
    "file": "/home/cprice/work/puppet/test/master/conf/modules/resource_type_foo/manifests/my_defined_type.pp",
    "parameters": {
      "param1": null,
      "param2": "\"default2\""
    "name": "resource_type_foo::my_defined_type",
    "kind": "defined_type"
    "line": 1,
    "file": "/home/cprice/work/puppet/test/master/conf/modules/resource_type_foo/manifests/my_node.pp",
    "name": "my_node",
    "kind": "node"

BREAK: Deprecated XML-RPC Support Is Entirely Removed

XML-RPC support has been removed entirely, in favor of the HTTP API introduced in 2.6. XML-RPC support has been deprecated since 2.6.0.

BREAK: Changes to Ruby API, Including Type and Provider Interface

The following hard changes have been made to Puppet's internal Ruby API:

  • Utility code: The Puppet::Util.symbolize method has been removed. Some older types and providers (notably the MySql module) used this function; if you get errors like undefined method 'symbolize' for #<Puppet::Type::..., you may need to upgrade your modules to newer versions. See ticket 16791 for more information.
  • Helper code: String#lines and IO#lines revert to standard Ruby semantics. Puppet used to emulate these methods to accomodate ancient Ruby versions, and its emulation was slightly inaccurate. We've stopped emulating them, so they now include the separator character ($/, default value \n) in the output and include content where they previously wouldn't.
  • Functions: Puppet functions called from Ruby code (templates, other functions, etc.) must be called with an array of arguments. Puppet has always expected this, but was not enforcing it. See ticket #15756 for more information.
  • Faces: The set_default_format method has been removed. It had been deprecated and replaced by render_as.
  • Resource types: The following methods for type objects have been removed: states, newstate, [ ], [ ]=, alias, clear, create, delete, each, and has_key?.
  • Providers: The mkmodelmethods method for provider objects has been removed. It was replaced with mk_resource_methods.
  • Providers: The LANG, LC_*, and HOME environment variables are now unset when providers and other code execute external commands.

The following Ruby methods are now deprecated:

  • Applications: The Puppet::Application class's #should_parse_config, #should_not_parse_config, and #should_parse_config? methods are now deprecated, and will be removed in a future release. They are no longer necessary for individual applications and faces, since Puppet now automatically determines when the config file should be re-parsed.

BREAK: Changes to Agent Lockfile Behavior

Puppet agent now uses two lockfiles instead of one:

  • The run-in-progress lockfile (configured with the agent_catalog_run_lockfile setting) is present if an agent catalog run is in progress. It contains the PID of the currently running process.
  • The disabled lockfile (configured with the agent_disabled_lockfile setting) is present if the agent was disabled by an administrator. The file is a JSON hash which may contain a disabled_message key, whose value should be a string with an explanatory message from the administrator.

DEPRECATION: Ruby DSL is Deprecated

The Ruby DSL that was added in Puppet 2.6 (and then largely ignored) is deprecated. Deprecation warnings have been added to Puppet 3.1.

Automatic Data Bindings for Class Parameters

When you declare or assign classes, Puppet now automatically looks up parameter values in Hiera. See Classes for more details.

Hiera Functions Are Available in Core

The hiera, hiera_array, hiera_hash, and hiera_include functions are now included in Puppet core. If you previously installed these functions with the hiera-puppet package, you may need to uninstall it before upgrading.

Major Speed Increase

Puppet 3 is faster than Puppet 2.6 and significantly faster than Puppet 2.7. The exact change will depend on your site's configuration and Puppet code, but many 2.7 users have seen up to a 50% improvement.

Solaris Improvements

  • Puppet now supports the ipkg format, and is able to "hold" packages (install without activating) on Solaris.
  • Zones support is fixed.
  • Zpool support is significantly improved.

Rubygem Extension Support

Puppet can now load extensions (including subcommands) and plugins (custom types/providers/functions) from gems. See ticket #7788 for more information.

Puppet Agent Is More Efficient in Daemon Mode

Puppet agent now forks a child process to run each catalog. This allows it to return memory to system more efficiently when running in daemon mode, and should reduce resource consumption for users who don't run puppet agent from cron.

puppet parser validate Will Read From STDIN

Piped content to puppet parser validate will now be read and validated, rather than ignoring it and requiring a file on disk.

The HTTP Report Processor Now Supports HTTPS

Use an https:// URL in the report_server setting to submit reports to an HTTPS server.

The include Function Now Accepts Arrays

Formerly, it would accept a comma separated list but would fail on arrays. This has been remedied.

unless Statement

Puppet now has an unless statement.

Puppet Agent Can Use DNS SRV Records to Find Puppet Master

Note: This feature is meant for certain unusual use cases; if you are wondering whether it will be useful to you, the answer is probably "No, use round-robin DNS or a load balancer instead."

Usually, agent nodes use the server setting from puppet.conf to locate their puppet master, with optional ca_server and report_server settings for centralizing some kinds of puppet master traffic.

If you set use_srv_records to true, agent nodes will instead use DNS SRV records to attempt to locate the puppet master. These records must be configured as follows:

Server SRV record
Puppet master _x-puppet._tcp.$srv_domain
CA server (if different) _x-puppet-ca._tcp.$srv_domain
Report server (if different) _x-puppet-report._tcp.$srv_domain
File server* (if different) _x-puppet-fileserver._tcp.$srv_domain

The srv_domain setting can be used to set the domain the agent will query; it defaults to the value of the domain fact. If the agent doesn't find an SRV record or can't contact the servers named in the SRV record, it will fall back to the server/ca_server/report_server settings from puppet.conf.

* (Note that the file server record is somewhat dangerous, as it overrides the server specified in any puppet:// URL, not just URLs that use the default server.)

All Bugs Fixed in 3.0.0

Use the Puppet issue tracker to find every bug fixed in a given version of Puppet.

You can’t perform that action at this time.