gcp-pubsub-emulator-ui

A UI console for the Google Cloud Platform PubSub emulator.

Getting started

docker run -p 8680:8080 --env PUBSUB_EMULATOR_HOST=<emulator-host>:<emulator-port> --env GCP_PROJECT_IDS=<comma-separated-project-ids> gcp-pubsub-emulator-ui:latest

The UI runs on http://localhost:8680 by default.

Running by pointing at local emulator

docker run -p 8680:8080 --env PUBSUB_EMULATOR_HOST=host.docker.internal:8681 --env GCP_PROJECT_IDS=company-dev,company-staging gcp-pubsub-emulator-ui:latest

Running in an existing docker-compose.yaml

version: "3.8"
services:
  ...
  pubsub-emulator-ui:
    image: echocode/gcp-pubsub-emulator-ui:latest
    ports:
      - "8680:8680"
    environment:
      - PUBSUB_EMULATOR_HOST=pubsub-emulator:8681
      - GCP_PROJECT_IDS=company-dev,company-staging

Running a complete example

Spin up a local emulator in Docker (using marcelcorso/gcloud-pubsub-emulator) with projects, topics, subscriptions and this UI console:

version: "3.8"
services:

  pubsub-emulator:
    image: messagebird/gcloud-pubsub-emulator:latest
    ports:
      - "8681:8681"
    environment:
      - PUBSUB_PROJECT1=company-dev,invoices:invoice-calculator,chats:slack-out:irc-out,notifications
      - PUBSUB_PROJECT2=company-staging,invoices:invoice-calculator

  pubsub-emulator-ui:
    image: echocode/gcp-pubsub-emulator-ui:latest
    ports:
      - "8680:8680"
    environment:
      - PUBSUB_EMULATOR_HOST=pubsub-emulator:8681
      - GCP_PROJECT_IDS=company-dev,company-staging

Local development

• Install Java 11

• Clone the project: git@github.com:echocode-io/gcp-pubsub-emulator-ui.git

• Build and run tests: ./gradlew clean build

Built with

• Micronaut as the webserver.
• Geb and Spock for automated testing.
• marcelcorso/gcloud-pubsub-emulator for simulating and testing the emulator.