python-etcd

Client 对象

['_MDELETE', '_MGET', '_MPOST', '_MPUT', '__class__', '__contains__', '__del__', '__delattr__', '__dict__', '__doc__', '__format__', '__getattribute__', '__hash__', '__init__', '__module__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__setattr__', '__sizeof__', '__str__', '__subclasshook__', '__weakref__', '_allow_reconnect', '_allow_redirect', '_base_uri', '_check_cluster_id', '_comparison_conditions', '_del_conditions', '_discover', '_get_headers', '_handle_server_response', '_machines_cache', '_next_server', '_protocol', '_read_options', '_read_timeout', '_result_from_response', '_sanitize_key', '_stats', '_use_proxies', '_wrap_request', 'allow_redirect', 'api_execute', 'api_execute_json', 'base_uri', 'delete', 'election', 'eternal_watch', 'expected_cluster_id', 'get', 'get_lock', 'host', 'http', 'key_endpoint', 'leader', 'leader_stats', 'machines', 'members', 'password', 'pop', 'port', 'protocol', 'read', 'read_timeout', 'set', 'stats', 'store_stats', 'test_and_set', 'update', 'username', 'version_prefix', 'watch', 'write']

类属性

　　　　http

　　　　

　　实例属性

　　　　allow_redirect

　　　　base_uri

　　　　election　　　　　　　　　　　　　　# Election primitives were removed from etcd 2.0

　　　　expected_cluster_id

　　　　host

　　　　key_endpoint

　　　　leader

　　　　leader_stats

　　　　machines

　　　　members

　　　　port

　　　　protocol

　　　　read

　　　　read_timeout

　　　　stats

　　　　store_stats　　　　　　　　

　　　　version_prefix

　　instancemethod 实例方法

　　　　api_execute

　　　　api_execute_json

　　　　delete

　　　　eternal_watch

　　　　get

　　　　get_lock

　　　　pop

　　　　set　　　　

　　　　test_and_set

　　　　update

　　　　watch

　　　　write

　实例化对象

　  函数原型：

    def __init__(
            self,
            host='127.0.0.1',　　　　　　   # mixed：类型-字符串（IP地址），元组((host,port),(host.port）,...)  支持多个etcd服务端的连接。
            port=,　　　　　　　　　　　 #
            srv_domain=None,
            version_prefix='/v2',
            read_timeout=,
            allow_redirect=True,
            protocol='http',
            cert=None,
            ca_cert=None,
            username=None,
            password=None,
            allow_reconnect=False,
            use_proxies=False,
            expected_cluster_id=None,
            per_host_pool_size=
    ):

　实例：　

import etcd

#
client = etcd.Client() # this will create a client against etcd server running on localhost on port
client = etcd.Client(port=)
client = etcd.Client(host='127.0.0.1', port=)
client = etcd.Client(host='127.0.0.1', port=, allow_redirect=False) # wont let you run sensitive commands on non-leader machines, default is true
client = etcd.Client(
             host='127.0.0.1',
             port=,
             allow_reconnect=True,
             protocol='https',)

全局网络锁

 client = etcd.Client()
 lock = client.get_lock('/customer1', ttl=)

 # Use the lock object:
 lock.acquire()
 lock.is_locked()  # True
 lock.renew()
 lock.release()
 lock.is_locked()  # False

 # The lock object may also be used as a context manager:
 client = etcd.Client()
 lock = client.get_lock('/customer1', ttl=)
 with lock as my_lock:
     do_stuff()
     lock.is_locked()  # True
     lock.renew()
 lock.is_locked()  # False

 # 创建etcd客户端对象，
 # allow_redirect=True  这个参数是当断链的时候，etcd会再次复用connect创建可用的连接
 client = etcd.Client(
              host='127.0.0.1',
              port=,
              allow_reconnect=True,
              protocol='https',)

 client.write('/nodes/n1', )
10
 # with ttl 设置几秒，几秒后这数据就没了
 client.write('/nodes/n2', , ttl=)  　　# sets the ttl to  seconds
 
12 # create only
 client.write('/nodes/n3', 'test', prevExist=False)   prevExist 如果数据有的话，就不再插入了。 

 client.write('/nodes/n3', 'test2', prevValue='test1') 保证value以前是test1 

 # mkdir
 client.write('/nodes/queue', dir=True)   新版本不用这个也行，最少我不用指明dir   也是可以创建mkdir的
 
19 # Append a value to a queue dir
 client.write('/nodes/queue', 'test', append=True) #will write i.e. /nodes/queue/
 client.write('/nodes/queue', 'test2', append=True) #will write i.e. /nodes/queue/

对于数据的修改也可以用 update

 result = client.read('/foo')
 print(result.value) # bar
 result.value += u'bar'
 updated = client.update(result)
 print(updated.value)

用read()方法 从etcd获取节点数据

client.read('/nodes/n2').value

#recursive递归的目录
#sorted 排序
r = client.read('/nodes', recursive=True, sorted=True)
for child in r.children:
    print("%s: %s" % (child.key,child.value))

#相当于zookeeper的watch监听
client.read('/nodes/n2', wait=True) #Waits for a change in value in the key before returning.
client.read('/nodes/n2', wait=True, waitIndex=)