Hacking functionality into Riak for fun and profit

Follow Along:

http://dankerrigan.github.io/cre/index.html

Basho

Riak

Webmachine powers the HTTP API within Riak KV

Not content with Riak's perfectly simple API?

Add your own!

• Riak batch operations
• Document compression, encyption/decryption
• Document transform
• Authentication/Authorization

But Beware

• Unsupported and not recommended by Basho
• Worst case: Your code can break Riak
• Unexpected behavior? Probably not Riak

Live Dangerously!

Step 1: Modify Riak

• rebar.config: Adding your deps http://bit.ly/1iIJa4D
• rel/reltool.config: http://bit.ly/IXGi41 http://bit.ly/IQAmJz

Step 2: Write your app

• Hook into Riak's Webmachine http://bit.ly/18r3td0
• Specify Webmachine behavior http://bit.ly/1bn1fPb

Some Webmachine overrides

• service_available: pull path encoded variables
• allowed_methods: specify HTTP verbs
• content_types_provided: specify handling based on content-type
• Others: http://bit.ly/1d1KOag
• The Chart: http://bit.ly/1jwuSlp

Step 3: ...

https://github.com/drewkerrigan/custom_riak_endpoints

Step 4: Profit!

Questions?

Real Examples

• Yokozuna: http://github.com/basho/yokozuna
• Riak Json: http://github.com/basho-labs/riak_json
• multi-put and multi-delete: http://github.com/dankerrigan/custom_riak_endpoints