<a id="changelog"></a>

# Changelog

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

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

Each revision is versioned by the date of the revision.

## 2026-11-07

- Temporarily use the `3.2/edge` channel in HAProxy deployment examples while
  `3.2/stable` is unavailable.
- Replaced the `grafana-agent` subordinate charm with the `opentelemetry-collector`
  charm in the Terraform module and documentation.

## 2026-10-06

- Rotate HAProxy logs daily or above 1 GiB, retaining seven rotated logs. Check
  logrotate policies hourly to reduce disk exhaustion for high-traffic deployments.

## 2026-09-25

- docs: Onboarded `docs` folder into central management solution located at
  [platform-engineering-documentation-files](https://github.com/canonical/platform-engineering-documentation-files).

## 2026-09-01

- docs: Added a how-to guide for hashing client IP addresses in logs and a GDPR/privacy section on security practices.

## 2026-08-28

- Added a `client-ip-hash-salt` configuration option to hash client IP addresses in HAProxy logs.

## 2026-08-19

- Switched from PROXY protocol v1 to v2.

## 2026-07-17

- Added a `get-configuration` action to inspect the effective HAProxy configuration.

## 2026-07-06

- docs: Add a how-to guide for configuring the backend protocol.

## 2026-06-26

- docs: Add docs on the Terraform module.

## 2026-06-18

- docs: Migrated the RTD documentation URL under the Canonical domain.

## 2026-06-12

- Added `option forwardfor` by default for `haproxy-route` backends.

## 2026-06-05

- docs: Updated home page with additional information about HAProxy.

## 2026-05-28

- Added relation endpoints reference page.

## 2026-05-27

- Added optional `dns-record` relation to publish DNS A records for HAProxy hostnames.

## 2026-05-26

- Added `port_mapping` attribute to `haproxy-route-tcp` relation to allow mapping a range of frontend ports to a range of backend ports.

## 2026-05-25

- docs: Updated the home page to implement the new pattern for the “In this documentation” section.
- docs: Reorganized two tutorials to how-to section; expanded the upgrade guide

## 2026-04-21

- Do not render the default backend if there are no other backends in in the haproxy-route-tcp.

## 2026-04-17

- Added missing settings from haproxy-route-tcp relation template.

## 2026-04-01

- Fixed hosts validation in haproxy-route and haproxy-route-tcp relation libraries.

## 2026-01-19

- Fixed issues with the DDoS protection configurator charm found in staging.

## 2026-01-16

- Added terraform modules for the HAProxy DDoS Protection configurator charm.
- Added path rewrite support for gRPC backends.

## 2026-01-15

- Added header rewrite support for gRPC backends.
- Added missing settings from haproxy-route-tcp relation template.
- Added documentation for the HAProxy DDoS protection configurator charm.

## 2026-01-14

- Added requirer support for the `ddos_protection` interface on the HAProxy charm.

## 2026-01-09

- Updated HAProxy config to track connections per minute instead of rate limit.

## 2026-01-08

- Added the provider side of the `ddos-protection` interface.

## 2025-12-17

- Added the DDoS defaults in the HAProxy config files and a config option to disable the defaults.

## 2025-12-19

- Added `app_name` and missing endpoint outputs to the Terraform product.

## 2025-12-19

- Added support for custom gRPC frontend port using the `external_grpc_port` attribute.

## 2025-12-18

- Added the `ddos_protection` interface.
- Parametrize app_name for subordinates in Terraform product.

## 2025-12-11

- Added the skeleton code for the HAProxy DDoS protection configurator charm.

## 2025-11-27

- Updated the change artifact compliance workflow with an opt-out ability.

## 2025-11-24

- Added HTTP/2 support to HAProxy for both frontend and backend configurations.

## 2025-11-14

- Added GitHub workflow that checks whether a pull request contains a change artifact.

## 2025-11-13

- Added the `spoe-auth` library and requirer/provider class implementation.

## 2025-11-12

- Updated the haproxy-route library to add the `allow_http` attribute.

## 2025-10-14

- Added action `get-proxied-endpoints`.

## 2025-10-08

- Upgrading HAproxy apt package to `2.8.5-1ubuntu3.4`.

## 2025-09-23

- Add documentation for security practices.

## 2025-08-20

- Release notes for 2.8/stable were added.

## 2025-08-11

- Changelog added for tracking changes.
