https://pig.center/zh/docs/etcd/dev-internal/Recent content in 内部架构 on PIG.CENTERHugozh-CNTue, 08 Sep 2026 21:29:01 +0800https://pig.center/zh/docs/etcd/dev-internal/discovery_protocol/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/etcd/dev-internal/discovery_protocol/<p>发现服务协议有助于新 etcd 成员在集群引导阶段，通过共享的发现令牌和端点列表，发现集群中的所有其他成员。</p> <p>发现服务协议仅在集群引导阶段使用，不可用于运行时重配置或集群监控。</p>https://pig.center/zh/docs/etcd/dev-internal/logging/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/etcd/dev-internal/logging/<p>etcd 使用 <a href="https://github.com/uber-go/zap">zap</a> 库记录应用程序输出，输出按 <em>级别</em> 进行分类。日志消息的级别依据以下约定确定：</p> <ul> <li> <p>DebugLevel 日志通常非常庞大，通常在生产环境中禁用。</p> <ul> <li>示例： <ul> <li>向远程对等成员发送一条普通消息</li> <li>将日志条目写入磁盘</li> </ul> </li> </ul> </li> <li> <p>InfoLevel 为默认的日志优先级。</p>https://pig.center/zh/docs/etcd/dev-internal/modules/Mon, 01 Jan 0001 00:00:00 +0000https://pig.center/zh/docs/etcd/dev-internal/modules/<p>etcd 项目（自版本 3.5 起）采用多个 <a href="https://golang.org/ref/mod">golang 模块</a> ，托管于 <a href="https://golang.org/ref/mod#vcs-dir">单个仓库</a> 中。</p> <img class="td-image" src="https://pig.center/docs/etcd/dev-internal/img/modules.svg" alt="模块图" loading="lazy" decoding="async"><p>以下是各个模块：</p> <ul> <li> <p><strong>go.etcd.io/etcd/api/v3</strong> - 包含 API 定义 （如 protos 与 proto 生成的库），定义了 etcd 客户端与服务器之间的通信协议。</p> </li> <li> <p><strong>go.etcd.io/etcd/pkg/v3</strong> - etcd 使用的通用工具包集合，不针对 etcd 本身。仅当某个包未来可能被移出至独立仓库时，才应归入此处。请避免在此处添加依赖关系复杂的代码，因为这些依赖会自动成为客户端库的依赖（我们希望客户端库保持轻量）。</p>