Buildkite PubSub

A webhook handler that securely forwards Buildkite build events to Google Cloud Pub/Sub, enabling event-driven architectures and integrations with your Buildkite pipelines.

Overview

This service connects Buildkite's webhook system to Google Cloud Pub/Sub, allowing you to:

• Receive Buildkite build events (status changes, pipeline updates, etc.)
• Forward events securely to Pub/Sub topics
• Handle failures gracefully with Dead Letter Queue support
• Protect against cascading failures with Circuit Breaker pattern
• Monitor and alert on webhook delivery
• Filter and process events using Pub/Sub subscriptions
• Build event-driven workflows and integrations

Prerequisites

• Go 1.21+ for development
• Docker for container builds
• kubectl for deployment
• Orbstack for local Kubernetes
• ngrok for local webhook testing
• Google Cloud Project with Pub/Sub enabled
• Buildkite organization admin access for webhook configuration

Local Development

# Run locally
go run cmd/webhook/main.go

# Run tests
go test ./...

# Build container
docker build -t buildkite-webhook .

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE file for details.