Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

NeoScript/pubsub-emulator-ui

Repository files navigation

PubSub Emulator UI

This application is meant to assist in local development of software related to Google Pub/Sub. This will allow one to view and create pubsub messages as well as create topics + pull subscriptions on a locally hosted instance of the pubsub emulator

Quickstart

  1. Utilize docker to run the pubsub emulator ui
    docker run -p 4200:80 ghcr.io/neoscript/pubsub-emulator-ui:latest
    
    • Note if you want to also spin up an instance of the pubsub emulator take a look at the docker-compose.yml file in this project's root πŸ˜‰
  2. Add the project you would like to track Screenshot from 2024εΉ΄02月09ζ—₯ 09-15-28
  3. Now add topics/subscribers and send/receive messages as you would like πŸ˜„ Screenshot from 2024εΉ΄02月09ζ—₯ 09-16-26

Motivations

  • The current Google Pub/Sub emulator does not have any visual tooling
  • I hate having to communicate with the emulator strictly through code
  • An existing project (gcp-pubsub-emulator-ui) would allow users to pull messages, but was limited to only pulling 1 message at a time.
    • I didn't know enough about Maven/Gradle/Java to go in and modify so I just decided to rebuild the tool and try and pick-up some new skills in the process.

Setting Up For Development

  1. First Clone the repository

    git clone https://github.com/NeoScript/pubsub-ui.git
    
  2. Then open the folder with VSCode

    • vscode is not required, but I've got a .devcontainers setup that may be helpful
    cd pubsub-ui
    code .
    
  3. Reopen the workspace in a container

    • To learn more about devcontainers check out this link
  4. Spin up the supporting docker-compose file

    • note: we are currently spinning up this very helpful wrapper around the emulator.
    • at some point we may try and transition to just spinning up the gcloud sdk itself (if anyone knows an easy way, tell me!)
  5. Start serving the angular webapp

    cd webapp
    npm run start
    
  6. You should now be able to develop and have changes trigger refreshes on the webapp!


Additional Info

LICENSE: MIT

All improvements and suggestions are welcome!

About

A handy UI tool that provides visibility into the gcloud pusub emulator

Topics

Resources

License

Stars

Watchers

Forks

Packages

Contributors 3

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /