Plan upgrades by using compatibility reports

Before you upgrade a Puppet product or a Puppet Forge module, you can generate a compatibility report to help validate your upgrade plans. When you run a compatibility report, your current and planned Puppet configurations are compared. The report lists any Puppet modules that might have to be upgraded, added, or removed to meet compatibility and dependency requirements.

To evaluate other upgrade paths, you can run additional reports and save a maximum of 25 reports in your Forge profile. When you identify an appropriate configuration for your environment, you can download a Puppetfile listing the suggested modules and use the file to configure your new infrastructure.

The scope of the compatibility report includes only your specified version of Puppet Enterprise (PE) or open source Puppet, and modules published on Forge. The report does not account for the possible customization of Forge modules after download. Because every system environment is different, consider the compatibility report as a starting point for upgrade planning. Before you implement the configuration in a production environment, validate the configuration in a test environment.

For more information, see the following topics: