和 etcd 交互

    默认，为了向后兼容 etcdctl 使用 v2 API 来和 etcd 服务器通讯。为了让 etcdctl 使用 v3 API 来和etcd通讯，API 版本必须通过环境变量 设置为版本3。

    应用通过写入 key 来储存 key 到 etcd 中。每个存储的 key 被通过 Raft 协议复制到所有 etcd 集群成员来达到一致性和可靠性。

    这是设置 key foo 的值为 bar 的命令:

    1. $ etcdctl put foo bar
    2. OK

    读取 key

    应用可以从 etcd 集群中读取 key 的值。查询可以读取单个 key，或者某个范围的 key。

    假设 etcd 集群存储有下面的 key：

    1. foo = bar
    2. foo1 = bar1
    3. foo3 = bar3

    这是读取 key for 的值的命令：

    1. $ etcdctl get foo
    2. foo
    3. bar

    这是覆盖从 foo to foo9 的 key 的命令：

    1. $ etcdctl get foo foo9
    2. foo
    3. bar
    4. foo1
    5. bar1
    6. bar3

    读取 key 过往版本的值

    应用可能想读取 key 的被替代的值。例如，应用可能想通过访问 key 的过往版本来回滚到旧的配置。或者，应用可能想通过访问 key 历史记录的多个请求来得到一个覆盖多个 key 上的统一视图。

    因为 etcd 集群上键值存储的每个修改都会增加 etcd 集群的全局修订版本，应用可以通过提供旧有的 etcd 版本来读取被替代的 key。

    1. $ etcdctl put foo bar         # revision = 2
    2. $ etcdctl put foo1 bar1       # revision = 3
    4. $ etcdctl put foo1 bar1_new   # revision = 5

    这里是访问 key 的过往版本的例子：

    应用可以从 etcd 集群中删除一个 key 或者特定范围的 key。

    下面是删除 key foo 的命令：

    1. $ etcdctl del foo
    2. 1 # 删除了一个key

    这是删除从 foo to foo9 范围的 key 的命令：

    1. $ etcdctl del foo foo9
    2. 2 # 删除了两个key

    观察 key 的变化

    应用可以观察一个 key 或者特定范围内的 key 来监控任何更新。

    这是在 key foo 上进行观察的命令：

    1. $ etcdctl watch foo
    2. # 在另外一个终端: etcdctl put foo bar
    3. foo
    4. bar

    这是观察从 foo to foo9 范围key的命令：

    1. $ etcdctl watch foo foo9
    2. # 在另外一个终端: etcdctl put foo bar
    3. foo
    4. bar
    5. # 在另外一个终端: etcdctl put foo1 bar1
    6. foo1
    7. bar1

    观察 key 的历史改动

    应用可能想观察 etcd 中 key 的历史改动。例如，应用想接收到某个 key 的所有修改。如果应用一直连接到etcd，那么 watch 就足够好了。但是，如果应用或者 etcd 出错，改动可能发生在出错期间，这样应用就没能实时接收到这个更新。为了保证更新被接收，应用必须能够观察到 key 的历史变动。为了做到这点，应用可以在观察时指定一个历史修订版本，就像读取 key 的过往版本一样。

    假设我们完成了下列操作序列：

    1. etcdctl put foo bar         # revision = 2
    2. etcdctl put foo1 bar1       # revision = 3

    这是观察历史改动的例子：

    这是压缩修订版本的命令：

    1. $ etcdctl compact 5
    2. compacted revision 5
    4. # 在压缩修订版本之前的任何修订版本都不可访问
    5. $ etcdctl get --rev=4 foo
    6. Error:  rpc error: code = 11 desc = etcdserver: mvcc: required revision has been compacted

    授予租约

    应用可以为 etcd 集群里面的 key 授予租约。当 key 被附加到租约时，它的生存时间被绑定到租约的生存时间，而租约的生存时间相应的被 time-to-live (TTL)管理。租约的实际 TTL 值是不低于最小 TTL，由 etcd 集群选择。一旦租约的 TTL 到期，租约就过期并且所有附带的 key 都将被删除。

    这是授予租约的命令：

    1. # 授予租约，TTL为10秒
    2. $ etcdctl lease grant 10
    3. lease 32695410dcc0ca06 granted with TTL(10s)
    5. # 附加key foo到租约32695410dcc0ca06
    6. $ etcdctl put --lease=32695410dcc0ca06 foo bar
    7. OK

    撤销租约

    应用通过租约 id 可以撤销租约。撤销租约将删除所有它附带的 key。

    假设我们完成了下列的操作：

    1. $ etcdctl lease grant 10
    2. lease 32695410dcc0ca06 granted with TTL(10s)
    3. $ etcdctl put --lease=32695410dcc0ca06 foo bar
    4. OK

    这是撤销同一个租约的命令：

    1. $ etcdctl lease revoke 32695410dcc0ca06
    2. lease 32695410dcc0ca06 revoked
    4. $ etcdctl get foo
    5. # 空应答，因为租约撤销导致foo被删除

    应用可以通过刷新 key 的 TTL 来维持租约，以便租约不过期。

    假设我们完成了下列操作：

    1. $ etcdctl lease grant 10

    这是维持同一个租约的命令：

    注： 上面的这个命令中，etcdctl 不是单次续约，而是 etcdctl 会一直不断的发送请求来维持这个租约。