PBUG

This project contains a Puppet module that automates the application of debugging configurations to Puppet and Puppet Enterprise services.

See the usage section for more details.

Requirements

This module is compatible with Puppet 6.16.0 and newer, which translates to PE 2019.8 and newer. Older versions of PE may work, but have not been tested.

Usage

pbug::mitmproxy

This class configures a SystemD service that uses mitmproxy to capture SSL traffic generated by local PE services for inspection.

Start the service with systemctl start mitmproxy and then visit http://<node ip address>:9080 to view captured traffic. Stop the service when debugging is finished, otherwise it will buffer traffic and consume resources until halted.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Release 0.2.0 - 2021-03-09

First release with support for 2019.8.0

New Features

• A pbug::mitmproxy class that automates the setup of mitmproxy.org as a transparent proxy for intercepting local HTTPS traffic generated by PE services.

Removals

• Everything that was in 0.1.0. That content was untested and most of it relied on configurations that don't apply to PE 2019.8. Bits and pieces may return in future versions.

Release 0.1.0 - 2021-03-08

Initial release. This version is tagged, but was intentionally not released to the Puppet Forge as it contains a lot of untested configurations that broke with the move to Java 11 in PE 2019.

Future releases will remove most of this content and start from a tested base.