gobridge

GoBridge documentation

GoBridge routes messages between systems that do not speak the same protocol — MQTT, AWS SQS, Azure Service Bus, RabbitMQ (AMQP 0-9-1), AMQP 1.0 and HTTP — with durable delivery, dead-letter handling, clustering and observability.

New here? Read Scenario 1: MQTT-to-MQTT first: it walks a working bridge end to end. Then skim the Configuration Overview.


Start here

Page What it covers
Scenario 1: MQTT-to-MQTT A complete working bridge, start to finish
Configuration Overview How configuration is layered, sourced and reloaded
Deployment Guide · Scaling Running GoBridge for real, and sizing it
Health Checks and Graceful Shutdown Probes, shutdown sequence and budgets, exit codes
Container and Orchestrator Deployment Image pinning, probe wiring, building your own image
Troubleshooting · Diagnostic metrics Symptoms, causes and fixes; what each adapter counter means when it climbs

Configuration

Page What it covers
Configuration Overview Lifecycle, sources, layering, dynamic reconfiguration
Configuration Reference Field-by-field BridgeConfig reference
Routes and Runtime Reference Route shape and runtime behaviour
Failover Budget What exclusive-session failover costs, and what admission checks
Programmatic API Delivery hooks, the builder, runtime lifecycle
Transport Configuration Options common to every transport
Message Mapping What a message looks like on each side: attributes, properties, identity and subject per transport
Processors and Stores Filter, transform, circuit breaker, tenant
Store Backends Memory, SQLite and DynamoDB for each store role, and the pairing rules
Config Stores Where configuration is read from and written to

Transports

Transport Everyday description
MQTT The lightweight protocol devices and sensors use — options · behaviour · ingress headers · durable sessions · settlement recovery · broker support
AWS SQS Amazon’s managed queue
Azure Service Bus Microsoft’s managed queue and topics
RabbitMQ / AMQP 0-9-1 The widely-used in-house message broker
AMQP 1.0 Artemis, Solace, Qpid
HTTP POST ingress, server-sent-events egress

Security and credentials

Page What it covers
Credentials and HTTP API Credential URIs, admin and monitor APIs
Credential Rotation Rotating secrets without downtime
HTTP API · Admin endpoints · Examples Administering a running bridge
Monitor API Endpoints Health, liveness, readiness, topology and deep health

Clustering

Page What it covers
Cluster overview Running several replicas without duplicate delivery
Operating a cluster Day-to-day operation
Cost of ownership What a cluster costs to run

Scenarios

Progressive walkthroughs, from a single MQTT topic to cross-protocol bridging. See the scenarios index — a few starting points:

Operations

Area Pages
Runbooks Incident procedures — broker outages, rollbacks, rotation failures, migrations
AWS deployment Running on ECS/EFS with DynamoDB
Timing audit How timing correctness is enforced
Release notes Per-version notes

Design decisions

Architecture decision records — the choices behind the delivery model, clustering, storage and configuration.


Design and contributor documentation (architecture, domain model, glossary, plugin authoring, testing rules) is written for people changing GoBridge rather than running it. Each of those documents is a hub in the repository root; where one grew past what fits in a single sitting, its detail pages live under internals/ and the hub’s contents table routes to them. See the repository on GitHub.