go-mms

Go client for MET Messaging system (MMS)

How to use

Building

To be able to use the statik binary, you need to have go's bin directory in the path, most probably ~/go/bin or ~/.local/go/bin. We found this to be solved by using these paths:

export GOPATH=$HOME/go
export PATH=$GOPATH/bin:$PATH
export PATH=$PATH:/usr/local/go/bin

cd go-mms
make edeps
make statik
make deps
make

Use

See mms and mmsd

The first step is only relevant for a system where MMS has been installed as a module.

Core NATS

To run the nats server configured in core NATS

./mmsd

To post an event to a queue

./mms post --api-key key --production-hub url  --queue-name queueName

key is generated by running

./mmsd keys --gen

To subscribe to a queue

./mms s --production-hub nats://localhost:4222 --queue-name queueName

NATS Jetstream

To run the nats server configured to enable Nats Jetstream

./mmsd --nats-local=false --nats-url=url --cred-file=/path/to/cred-file.cred --nats-cred-path=/path/to/cred-file/directory

nats-local is true by default and is meant for `Core NATS``

To post an event to a queue

./mms post --api-key key --production-hub url  --queue-name queueName

key is key from the cred-file

To subscribe to a queue

./mms s nats-local=false --production-hub=nats-url --cred-file=path/to/credfile.cred --queue-name=queueName

When we are subscribing to a queue, we will get all the messages that were sent in last 12 hours.

Build and run MMSd as docker container

make image
docker run -i -p 4222:4222 -p 8080:8080 mmsd

Generate code diagram

install go-plantuml: go get -u github.com/bykof/go-plantuml
make puml