Chef::Etcd

Provides chef resource/provider to access etcd key value pairs and report/event handlers to publish chef run data into etcd.

Installation

Add this line to your application's Gemfile:

gem 'chef-etcd'

And then execute:

$ bundle

Or install it yourself as:

$ gem install chef-etcd

Usage

1. require the chef-etcd library in your client config (knife.rb/solo.rb/client.rb) and set Chef::Config[:etcd] to an existing etcd node.

require 'chef/etcd'
node_name 'something'
etcd_host = '192.168.122.1'
Chef::Config[:etcd]= {host:etcd_host}

2. you can use the resource/provider to get/set etcd keys

# setting keys
# idempotent, does not set the key if the value is same
etcd "/test/recipe/set" do
  action :set
  value Time.now.to_s
end

# set another key for delete operation
etcd "/test/recipe/delete" do
  action :set
  value Time.now.to_s
end
# delete the key. doesn't do anything if the key if absent
etcd "/test/recipe/delete" do
  action :delete
  value Time.now.to_s
end
# set one more key for show casing test_and_set
etcd "/test/recipe/test_and_set" do
  action :set
  value "0"
end

# this gets updated only when the test_and_set action fails. if it passes it sets updated_by_last_action to false.
# I intend to use this for notifying resources. Its prototype as of now
etcd "/test/recipe/test_and_set" do
  action :test_and_set
  value Time.now.to_s
  prev_value "0"
end

3. To publish node data using the report handler, or to monitor realtime chef resource convergence(event handler), add following configurations to your client.rb/solo.rb

event_handlers [Chef::EventDispatch::Etcd.new(host: etcd_host)]
report_handlers << Chef::Handler::EtcdReport.new(host: etcd_host)

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request