Version information
This version is compatible with:
- Puppet Enterprise 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x
- Puppet >= 6.16.0 < 8.0.0
- , , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'sharpie-pbug', '0.2.0'
Learn more about managing modules with a PuppetfileDocumentation
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.
Dependencies
- puppetlabs-stdlib (>= 6.6.0)