Skip to content

Latest commit

 

History

History

emitter

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
chart
chart
 
 
keygen
keygen
 
 
README.md
README.md
 
 
broker.yaml
broker.yaml
 
 
initialize
initialize
 
 
service.yaml
service.yaml
 
 

README.md

Emitter.io

Emitter.io is a MQTT broker with additional security provided via channel keys.

Get started

First run Emitter in docker to generate a EMITTER_LICENSE. (Note that this is not a software license key.)

kubectl run --rm -i -t emitter --image=emitter/server:latest --restart=Never

Check the logs for a randomly generated EMITTER_LICENSE.

2019/12/16 17:56:04 [service] unable to find a license, make sure 'license' value is set in the config file or EMITTER_LICENSE environment variable
2019/12/16 17:56:04 [license] generated new license: RfBEIGQlQNSLQfIlm-b4s-TNJirEjMhJu7rGA5FJW8BTMFTTGADk2MX9Tq0AaT_20-of7cDM-clmRbb7Z-n5itgHubSCgwcB:2
2019/12/16 17:56:04 [license] generated new secret key: 2EXofPVkJJq7GEoQkFHN3B_P63Y4DoX_
  • Create a Kubernetes secret to store the key
kubectl create secret generic emitter-secret -n openfaas --from-literal "secret=2EXofPVkJJq7GEoQkFHN3B_P63Y4DoX_" -o yaml --dry-run | kubectl apply -f -

Edit broker.yaml and deploy

  • Copy the new license into broker.yaml

  • Update replicas: 1 with the number of nodes, use "1" for the default

    For simplicity, the broker is deployed to the openfaas namespace.

    Run these commands:

    kubectl apply -f broker.yaml
kubectl apply -f service.yaml

Check the deployment

List the services to obtain the IP address of the Emitter load balancer.

 % kubectl --namespace openfaas get service emitter
 NAME      TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S) AGE
 emitter   ClusterIP   10.111.110.157    <pending>  8080:30790/TCP,8443:30705/TCP   8m40s

Check the logs of the service:

kubectl logs statefulset.apps/broker -n openfaas

Port-forward the Emitter's UI so that you can generate a channel key.

kubectl port-forward -n openfaas svc/emitter 8081:8080 &

You can now use the IP address to access the Emitter UI. In the above example you would go to http://127.0.0.1:8081/keygen. From there you can create channel keys, which allow you to secure individual channels and start using Emitter.

You will need to enter the secret from above i.e. aV3hzU01-SCF0wbnDdpXKCyxT4OB5Gad or similar. If you can't remember the password, then look it up from the Kubernetes secret, and decode it with kubectl get secret/emitter-secret -o yaml -n openfaas followed by base64 -D against the secret field.

  • Navigate to http://IP:port/keygen where IP is the address of your Emitter.io deployment

  • Generate a channel key for the drone-position/ topic

  • Now generate a second channel key for the drone-event/ topic

You'll need this key to configure the OpenFaaS Connector.