Table of Contents
Walrus uses pub/sub pattern to allow applications to subscribe to specific topics. A topic is any event or a concern that can happen on your systems, it can be a new account that was just created, or a credit card purchase. So any application that wants to be notified by new events, it will just need to subscribe to this topic. To make it possible, Walrus offers an rpc method called Subscribe which any service can call to establish a gRPC connection and start to listen for a server side message stream. Then, when a new event happen, any application can call the Publish rpc method to publish this event through Walrus that will send it to all subscriptions based on the event's topic.
All you should know to run Walrus locally.
- Clone the repo
git clone https://github.com/matheusmosca/walrus.git
- Run the server
make run-server
- Create generated files
make generate
- Build image
docker build --tag walrus . - Run the server in a container exposing the default port
docker run -d --name walrus-test --publish 3000:3000 walrus
- See the logs live
docker logs --follow walrus-test
- To stop the container run
docker stop walrus-test
You can test the server running the examples, first the subscriber, then the publisher.
make testTODO
Take a look at the open issues and let a comment on them if you want to help somehow. Feel free to share your ideas or report bugs by opening a new issue as well. Any contributions you make are really appreciated and I would love to review your pull requests. ❤️
Distributed under the APACHE-2.0 License. See LICENSE for more information.