etcd 3.7 中文文档 on PIG.CENTER

快速入门

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

按照以下步骤本地安装、运行并测试单成员 etcd 集群：

从预构建的二进制文件或源码安装 etcd。详情请参见 [安装][]。

警告

重要：务必完成安装说明的最后一步，确认可执行文件搜索路径中包含 etcd。

示例

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

本系列示例展示了操作 etcd 集群的基本流程。

认证

auth、user、role 用于身份认证：

export ETCDCTL_API=3
ENDPOINTS=localhost:2379

etcdctl --endpoints=${ENDPOINTS} role add root
etcdctl --endpoints=${ENDPOINTS} role get root

etcdctl --endpoints=${ENDPOINTS} user add root
etcdctl --endpoints=${ENDPOINTS} user grant-role root root
etcdctl --endpoints=${ENDPOINTS} user get root

etcdctl --endpoints=${ENDPOINTS} role add role0
etcdctl --endpoints=${ENDPOINTS} role grant-permission role0 readwrite foo
etcdctl --endpoints=${ENDPOINTS} user add user0
etcdctl --endpoints=${ENDPOINTS} user grant-role user0 role0

etcdctl --endpoints=${ENDPOINTS} auth enable
# now all client requests go through auth

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# permission denied, user name is empty because the request does not issue an authentication request
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 can read the key foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

安装

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

先决条件

安装 etcd 之前，请参阅以下页面：

[支持的平台][]
[硬件建议][]

安装预构建二进制文件

安装 etcd 最简便的方式是使用预构建的二进制文件：

功能门控

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

本文概述了管理员可在 etcd 中指定的各种功能门控。

请参阅 feature stages 了解功能各阶段的说明。

概述

功能门控是一组描述 etcd 特性的 key=value 键值对。可使用 etcd 的 --feature-gates 命令行标志来开启或关闭这些特性。

常见问题

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

etcd，通用

etcd 是什么？

etcd 是一个一致性的分布式键值存储。主要用于分布式系统中的独立协调服务，专为存储可完全容纳在内存中的少量数据而设计。

库和工具

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

请注意，以下第三方库和工具未托管在 https://github.com/etcd-io 下，也未经 etcd 团队测试或维护。使用前应自行阅读相关资料并评估其可靠性。

工具

etcdctl - etcd 的命令行客户端
etcd-dump - 用于导出/恢复 etcd 的命令行工具
etcd-fs - etcd 的 FUSE 文件系统
etcddir - 实时同步 etcd 与本地目录的工具，支持 Windows 和 Linux
etcd-browser - 基于 AngularJS 的 Web 端键值编辑器，用于 etcd
etcd-lock - 基于 etcd 实现的领导者选举与分布式读写锁，支持 v2 版本
etcd-console - 基于 PHP 的 Web 端键值编辑器，用于 etcd
etcd-viewer - 使用 Java 编写的 etcd 键值存储编辑器/查看器
etcdtool - 将 etcd 目录导出/导入/编辑为 JSON/YAML/TOML 格式，并使用 JSON Schema 验证目录
etcdloadtest - 用于 etcd 3.0 及以上版本的命令行负载测试客户端
etcd-tui - 用于与 etcd 数据库交互的现代终端用户界面（TUI），可在终端中导航键、查看值、过滤数据，并直接管理 etcd 集群
etcdfinder - 一款快速、现代的 Web UI，支持 etcd v2 和 v3，具备即时搜索功能
lucas - 用于 Kubernetes etcd 3.0+ 集群的 Web 端键值查看器
etcd-manager - 一款现代、高效、跨平台且免费的 etcd 3.x 图形界面与客户端工具，支持 Windows、Linux 和 Mac
etcd-backup-restore - 用于定期且增量备份与恢复 etcd 的工具
etcd-druid - 用于部署 etcd 集群并管理日常运维操作的 Kubernetes Operator
etcdadm - 用于操作 etcd 集群的命令行工具
etcd-defrag - 更易用且智能的 etcd 碎片整理工具
etcdhelper - 适用于 IntelliJ 平台的 etcd 插件

库

以下各节按语言列出了 etcd 客户端库。

报告缺陷

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

如果 etcd 项目任何部分存在缺陷或文档错误，请通过打开问题告知我们。我们高度重视缺陷和错误，认为任何问题都不算太小。创建缺陷报告前，请确认尚未存在报告相同问题的议题。

调优

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

默认情况下，etcd 的配置在平均网络延迟较低的本地网络环境中应能良好运行。然而，当在多个数据中心之间或高延迟网络上使用 etcd 时，可能需要调整心跳间隔和选举超时设置。