Puppet module for managing Foreman integration in Puppetserver

The Foreman integration consists of an ENC and a report processor. This has a configuration file. All of this can be managed by this module.

Historically this integration was part of theforeman-foreman module.

Compatibility

• Foreman API v2: 1.3 - 3.x
• Puppetserver: 7.x - 8.x

These scripts have a long history and have basically been unchanged since Puppet 2.6, even before Puppetserver existed. They have been adopted to leverage some more modern Ruby methods and require at least Ruby 2.6, but can probably still handle old reports.

Puppet Enterprise integration

People running Puppet Enterprise use the PE Console as ENC. To make a migration to OpenVox/Foreman easier, you can use this module to send facts to Foreman, in parallel to using the PE Console. This is handled with the foreman_puppetserver::fact_watcher_service boolean. It defaults to true on Puppet Enterprise. When set to true, it will create fact_watcher.service. It watches continuously for new facts and uploads them to Foreman.

Changelog

4.2.1 (2025-05-13)

Full Changelog

Fixed bugs:

• Bring back Ruby 2.6 compatiblity #63 (ekohl)

4.2.0 (2025-05-09)

Full Changelog

Implemented enhancements:

• Use better Ruby methods to transform items #60 (ekohl)
• Remove legacy MAC address quoting workaround #59 (binford2k)
• Add service to publish facts to foreman #52 (bastelfreak)

Fixed bugs:

• puppet/systemd: Allow 7.x #61 (bastelfreak)

4.1.0 (2025-02-12)

Full Changelog

Implemented enhancements:

• Add support for running on PE #51 (bastelfreak)
• Add AlmaLinux 8 & 9 support #48 (archanaserver)
• Simplify the report processor #24 (ekohl)

Fixed bugs:

• enc.rb: Switch from legacy to structured facts #53 (bastelfreak)

4.0.0 (2024-05-16)

Full Changelog

Breaking changes:

• Use namespaced ensure_packages, require puppetlabs/stdlib 9.x #44 (gcoxmoz)

Fixed bugs:

• Fix Deprecation-Warning #46 (cocker-cc)

3.1.0 (2024-03-26)

Full Changelog

Implemented enhancements:

• Add support for Debian 11 and 12 #42 (evgeni)
• Add Ubuntu 20.04 and 22.04 support #41 (evgeni)
• Prepare for Ruby 3. Replace File.exists? with File.exist? #40 (tuxmea)
• Make TLS authentication to foreman optional #39 (bastelfreak)

3.0.0 (2023-11-14)

Full Changelog

Breaking changes:

• Drop Puppet 6 support #37 (ekohl)

Implemented enhancements:

• Add Puppet 8 support #34 (bastelfreak)
• Use YAML.safe_load #27 (ekohl)

2.4.0 (2023-08-16)

Full Changelog

Implemented enhancements:

• puppetlabs/stdlib: Allow 9.x #33 (bastelfreak)
• Fixes #36573 - Reuse foreman_url answer from foreman_proxy module #31 (ekohl)

2.3.0 (2023-06-20)

Full Changelog

Implemented enhancements:

• Refs #35833 - Revert "Fixes #35684 - Drop Applied catalog lines" #29 (ekohl)

2.2.0 (2022-10-28)

Full Changelog

Implemented enhancements:

• Fixes #35684 - Drop Applied catalog lines #25 (ekohl)
• Update to voxpupuli-test 5 #22 (ekohl)
• Serve from cache when response.code != 200 #21 (idl0r)

2.1.0 (2022-02-03)

Full Changelog

Implemented enhancements:

• Add report_retry_limit setting #18 (jplindquist)
• puppetlabs/stdlib: Allow 8.x #16 (bastelfreak)

Merged pull requests:

• Correct assertion to reflect ensure_packages new default #15 (ekohl)
• Fix project URLs used by puppet forge #14 (neomilium)

2.0.0 (2021-07-23)

Full Changelog

Breaking changes:

• Drop Puppet 5 support #10 (ehelms)

Implemented enhancements:

• Allow Puppet 7 compatible versions of mods #8 (ekohl)

1.0.0 (2021-04-26)

Full Changelog

Merged pull requests:

• Support Puppetserver 7 #6 (ekohl)
• Switch from Travis CI to Github Actions #3 (ekohl)
• Port over code from puppet-foreman #1 (ekohl)

* This Changelog was automatically generated by github_changelog_generator