Released on March 3, 2026, ghook2pubsub v0.2.0 introduces payload compression, allowing users to significantly reduce the data volume of GitHub webhooks published to Google Cloud Pub/Sub. This update is designed for high-volume event streams where reducing egress and storage costs is a priority.

What’s new

The headline feature of this release is the introduction of optional payload compression. You can now compress webhook payloads before they reach Pub/Sub using two industry-standard algorithms:

  • gzip: The reliable baseline for maximum compatibility with downstream consumers.
  • zstd: A modern alternative providing a superior balance of compression speed and ratio.

Configuration is handled entirely through environment variables:

  • PAYLOAD_COMPRESSION: Define your algorithm and compression level (e.g., zstd:3).
  • PAYLOAD_COMPRESSION_ATTRIBUTE: Specify a custom attribute name to let downstream services know which algorithm was used, ensuring a seamless decompression process.

Alongside these technical additions, we’ve overhauled our documentation. A new attributes.md guide provides a detailed contract of the Pub/Sub attributes derived from GitHub headers and payloads, and our configuration guide now includes a strategy for zero-downtime secret rotation.

Why it matters

For organizations processing thousands of GitHub events, the size of the payload can lead to substantial GCP Pub/Sub costs and potential throughput bottlenecks. By implementing compression at the bridge level, you can:

  1. Lower Costs: Reduce the total amount of data ingested by Pub/Sub.
  2. Increase Efficiency: Improve the throughput of your event-driven architecture.
  3. Maintain Clarity: Use the new compression attributes to maintain a strict data contract with your downstream consumers.

Getting started with v0.2.0

Upgrading is straightforward: simply update your deployment to use the v0.2.0 Docker image.

To enable compression, add the PAYLOAD_COMPRESSION variable to your environment. We strongly recommend also setting PAYLOAD_COMPRESSION_ATTRIBUTE so your downstream subscribers can programmatically detect and decompress the payloads.

This post was AI-generated using the model unsloth/gemma-4-31B-it-GGUF:UD-Q5_K_XL. Reference: UnitVectorY-Labs/ghook2pubsub, Release v0.2.0 on 2026-04-11. Author: release-storyteller