NAME
Net::Etcd
SYNOPSIS
Etcd v3.1.0 or greater is required. To use the v3 API make sure to set environment
variable ETCDCTL_API=3. Precompiled binaries can be downloaded at https://github.com/coreos/etcd/releases.
$etcd = Net::Etcd->new(); # host: 127.0.0.1 port: 2379
$etcd = Net::Etcd->new({ host => $host, port => $port, ssl => 1 });
# put key
$result = $etcd->put({ key =>'foo1', value => 'bar' });
# get single key
$key = $etcd->range({ key =>'test0' });
# return single key value or the first in a list.
$key->get_value
# get range of keys
$range = $etcd->range({ key =>'test0', range_end => 'test100' });
# return array { key => value } pairs from range request.
my @users = $range->all
# watch key range, streaming.
$watch = $etcd->watch( { key => 'foo', range_end => 'fop'}, sub {
my ($result) = @_;
print STDERR Dumper($result);
})->create;
# create/grant 20 second lease
$etcd->lease( { ID => 7587821338341002662, TTL => 20 } )->grant;
# attach lease to put
$etcd->put( { key => 'foo2', value => 'bar2', lease => 7587821338341002662 } );DESCRIPTION
This module has been superseded by Net::Etcd and will be removed from CPAN on June 29th 2017
ACCESSORS
host
port
username
password
ssl
api_root
api_prefix
defaults to /v3alpha
api_path
auth_token
PUBLIC METHODS
watch
Returns a Net::Etcd::Watch object.
$etcd->watch({ key =>'foo', range_end => 'fop' })role
Returns a Net::Etcd::Auth::Role object.
$etcd->role({ role => 'foo' });user_role
Returns a Net::Etcd::User::Role object.
$etcd->user_role({ name => 'samba', role => 'foo' });auth
Returns a Net::Etcd::Auth object.
lease
Returns a Net::Etcd::Lease object.
user
Returns a Net::Etcd::User object.
put
Returns a Net::Etcd::KV::Put object.
range
Returns a Net::Etcd::KV::Range object.
configuration
Initialize configuration checks to see it etcd is installed locally.
AUTHOR
Sam Batschelet, <sbatschelet at mac.com>
ACKNOWLEDGEMENTS
The etcd developers and community.
CAVEATS
The etcd v3 API is in heavy development and can change at anytime please see https://github.com/coreos/etcd/blob/master/Documentation/dev-guide/api_reference_v3.md for latest details.
LICENSE AND COPYRIGHT
Copyright 2017 Sam Batschelet (hexfusion).
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.