Demonstrates embedding choria server in another go app
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


The Choria Go daemon is embeddable into other Go applications.

The use case here is if you have some existing code, or wish to make a very focussed custom app, but want to:

  • Make use of the Choria protocol security
  • Make use of the Choria network protocol design to avoid doing your own
  • Publish data to Choria registration system where the adapters can be used to rewrite the data into kafka/graphite/etc
  • Host your own custom Go agent that can interact with the internals of your app
  • Compile it into your binary

This is a demonstration that runs on a Raspberry Pi, it reads weather and humidity from a DHT220 sensor.


  • Hard codes and compiles in all the needed configuration - you'd use your own provisioning system to get this data
  • Exposes weather data to the Choria registration system and publish it regularly
  • Has a custom Choria agent that expose weather data on demand
  • Embeds a Choria server into it and connect to some middleware
  • Disables TLS and Cert based security - bad idea you would integrate with Consul/AWS IOT to get certs in the real world

It does not use the old mcollective DDL files, but it includes one so your Ruby mcollective configured with Choria can communicate with this agent

NOTE: To build this on a non rpi you do GOOS=linux GOARCH=arm GOARM=5 go build

root@f35711d:/usr/src/app# DH2200_PIN=GPIO_4 ./choriapi
INFO[0000] Initial servers: []choria.Server{choria.Server{Host:"", Port:4222, Scheme:"nats"}}  component=server identity=f35711d
INFO[0000] Connected to nats://         component=server identity=f35711d
INFO[0000] Registering new agent discovery of type discovery  component=server identity=f35711d subsystem=agents
INFO[0000] Subscribing agent discovery to mcollective.broadcast.agent.discovery  component=server identity=f35711d subsystem=agents
INFO[0000] Subscribing node f35711d to mcollective.node.f35711d  component=server identity=f35711d
INFO[0000] Registering new agent dht220 of type dht220   component=server identity=f35711d subsystem=agents
INFO[0000] Subscribing agent dht220 to mcollective.broadcast.agent.dht220  component=server identity=f35711d subsystem=agents
2017/12/04 22:30:18 Starting to send data every 60 seconds
2017/12/04 22:30:18 Publishing {"temperature":18.8,"humidity":55,"time":"2017-12-04T22:30:18.610248213Z"}
INFO[0000] Sending a broadcast message to NATS target 'mcollective.broadcast.agent.temperature' for message dca08402796f4ca78b578f4a7f5570d6 type request

Here the Choria security is disabled so no encryption or TLS, the data this sends can be seen here:

% nats-sub -s nats:// mcollective.broadcast.agent.temperature
[#1] Received on [mcollective.broadcast.agent.temperature] : '{"protocol":"choria:transport:1","data":"eyJwcm90b2NvbCI6ImNob3JpYTpzZWN1cmU6cmVxdWVzdDoxIiwibWVzc2FnZSI6IntcInByb3RvY29sXCI6XCJjaG9yaWE6cmVxdWVzdDoxXCIsXCJtZXNzYWdlXCI6XCJleUowWlcxd1pYSmhkSFZ5WlNJNk1UZ3VPQ3dpYUhWdGFXUjVJam8xTmk0MUxDSjBhVzFsSWpvaU1qQXhOeTB4TWkwd05GUXlNam96TmpvME1pNDJNelkyTVRrNU1UTmFJbjA9XCIsXCJlbnZlbG9wZVwiOntcInJlcXVlc3RpZFwiOlwiYmJiOTVjNzNlYWRiNDFjMzlmODJhN2VlZGZmZWNlZTFcIixcInNlbmRlcmlkXCI6XCJmMzU3MTFkXCIsXCJjYWxsZXJpZFwiOlwiY2hvcmlhPWYzNTcxMWRcIixcImNvbGxlY3RpdmVcIjpcIm1jb2xsZWN0aXZlXCIsXCJhZ2VudFwiOlwidGVtcGVyYXR1cmVcIixcInR0bFwiOjYwLFwidGltZVwiOjE1MTI0MjcwMDIsXCJmaWx0ZXJcIjp7XCJmYWN0XCI6W10sXCJjZl9jbGFzc1wiOltdLFwiYWdlbnRcIjpbXSxcImlkZW50aXR5XCI6W10sXCJjb21wb3VuZFwiOltdfX19Iiwic2lnbmF0dXJlIjoiaW5zZWN1cmUiLCJwdWJjZXJ0IjoiaW5zZWN1cmUifQ==","headers":{"reply-to":"dev.null","mc_sender":"f35711d","seen-by":[["nats://","f35711d","nats://"]]}}'

The data is Base64 encoded and contains the onion layers leading down to the real data:

From the Transport get the Secure Request:

% cat|base64 -d

Get the data in the Request:

% cat|base64 -d

In includes a DDL file for the ruby Choria, if installed and configured you can interact with your RPC:

NOTE: The DDL isn't used by the Go code

[rip@dev1]% mco rpc dht220 reading --config .mcollective.choriapi
Discovering hosts using the mc method for 2 second(s) .... 1

 * [ ============================================================> ] 1 / 1

        Humidity: 54.6
   Temperature: 18.5
          Time: 2017-12-05T08:11:59.623588181Z

Finished processing 1 / 1 hosts in 696.85 ms