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
-
requirethe chef-etcd library in your client config (knife.rb/solo.rb/client.rb) and setChef::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}- 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- 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
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request