~/projects/google-pubsub.md

google-pubsub

active

A lightweight Google Cloud Pub/Sub emulator written in pure Go — tiny scratch image, full gRPC API compatibility.

gogrpcdockerpubsubemulator

A drop-in replacement for the official Google Cloud Pub/Sub emulator. The official one is a Java app shipped in a ~600 MB Docker image — this one is a single static Go binary in a scratch image.

Fully compatible with the cloud.google.com/go/pubsub client library.

Features

  • Full Publisher API — topics, publish, field-mask updates, retention
  • Full Subscriber API — pull, streaming pull, ack/nack, dead-letter, ordering
  • Snapshots — create, seek-to-snapshot, seek-to-time
  • Init config — pre-create topics and subscriptions on startup
  • Validated against the real Google emulator with the same integration test suite

Quick start

docker run --rm -p 8085:8085 ghcr.io/fbufler/google-pubsub:latest
export PUBSUB_EMULATOR_HOST=localhost:8085
main
dark