学习 on PIG.CENTER

数据模型

Mon, 01 Jan 0001 00:00:00 +0000

etcd 旨在可靠地存储更新频率较低的数据，并提供可靠的监听查询。etcd 通过暴露键值对的旧版本，支持低成本的快照和监听历史事件（“时间旅行查询”）。持久化、多版本、并发控制的数据模型非常适合这些应用场景。

etcd 客户端设计

Mon, 01 Jan 0001 00:00:00 +0000

etcd 客户端设计

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

简介

etcd 服务器通过多年的故障注入测试验证了其稳健性。大多数复杂的应用逻辑已由 etcd 服务器及其数据存储处理（例如，集群成员关系对客户端透明，提案通过 Raft 层转发至领导者）。尽管服务器组件本身正确，但其与客户端的组合需采用一组复杂的协议，以确保在故障条件下仍能保证正确性和高可用性。理想情况下，etcd 服务器为多台物理机器提供单一逻辑集群视图，客户端则实现副本间的自动故障转移。本文档描述客户端的架构决策及其具体实现细节。

etcd 学习者成员设计

Mon, 01 Jan 0001 00:00:00 +0000

etcd 学习者成员

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

背景

成员变更配置一直是运维中最大的挑战之一。回顾常见问题。

etcd v3 身份认证设计

Mon, 01 Jan 0001 00:00:00 +0000

为什么不重用 v2 认证系统？

v3 协议使用 gRPC 作为传输机制，而非 v2 所采用的 RESTful 接口。这一新协议为迭代和改进 v2 设计提供了机会。例如，v3 身份认证采用基于连接的身份认证，而非 v2 每请求身份认证的较慢方式。此外，v2 身份认证在实际应用中关于一致性推理的语义往往难以处理，这一点将在后续章节中详述。对于 v3，身份认证机制具有明确定义的描述和实现，解决了 v2 身份认证系统中的缺陷。

etcd API

Mon, 01 Jan 0001 00:00:00 +0000

本文旨在概述 v3 版 etcd API 的核心设计。切勿将本指南与已弃用的 etcd v2 API 混淆，后者已于 etcd v3.5 中弃用。本文并非全面涵盖所有内容，而是聚焦于理解 etcd 所需的基本概念，避免被较少使用的 API 调用分散注意力。所有 etcd API 均定义在 [gRPC services][grpc-service] 中，这些服务对 etcd 服务器所理解的远程过程调用（RPC）进行了分类。所有 etcd RPC 的完整列表已在 [gRPC API listing][grpc-api] 的 Markdown 文档中记录。

etcd 持久化存储文件

Mon, 01 Jan 0001 00:00:00 +0000

本文介绍了 etcd 持久化存储格式：命名规则、内容结构以及可供开发者用于检查存储内容的工具。后续应随着存储模型的变更持续扩展本文内容。本文面向 etcd 开发者，旨在帮助其满足数据恢复需求。

etcd API 保证

Mon, 01 Jan 0001 00:00:00 +0000

etcd 是一个一致且持久的键值存储系统。键值存储通过 gRPC Services 暴露。etcd 为分布式系统提供最强的一致性和持久性保证。本文规范列出了 etcd 所提供的 API 保证。

值得考虑的 API

KV API
- 范围
- 范围流
- 写入
- 删除
- 事务
监听 API
- 监听
租约 API
- 授予
- [撤销]
- 保活

KV API 支持对键值存储进行直接读取和操作。监听 API 支持订阅键值存储的变更。租约 API 支持为键指定生存时间（TTL）。

etcd 与其它键值存储系统比较

Mon, 01 Jan 0001 00:00:00 +0000

etcd 这个名称源自两个理念：Unix 系统中的“/etc”目录和“d”istributed（分布式）系统。其中，“/etc”目录是用于存储单个系统配置数据的路径，而 etcd 则用于存储大规模分布式系统的配置信息。因此，“d”istributed “/etc”即为 etcd。

术语表

Mon, 01 Jan 0001 00:00:00 +0000

本文定义了 etcd 文档、命令行和源代码中使用的各种术语。

告警

当集群需要操作员干预以保持可靠性时，etcd 服务器会触发告警。