快速学习安装使用etcd

1. 什么是 etcd？

etcd 是一个分布式键值存储系统，主要用于分布式系统的配置管理和服务发现。它提供了可靠的数据存储，etcd 可以用来构建高可用的分布式键值数据库，根据官网介绍并且支持分布式锁、Leader 选举等功能，通常被用作微服务架构中的注册中心。在目前go的大部分组件还有框架中都被采用为注册中心组件相当于zookper和redis

2. 安装 etcd

2.1. 在本地安装 etcd

2.1.1. Linux/MacOS

在 Linux 或 MacOS 上，你可以通过以下步骤安装 etcd：

wget https://github.com/etcd-io/etcd/releases/download/v3.5.9/etcd-v3.5.9-linux-amd64.tar.gz
tar -xvf etcd-v3.5.9-linux-amd64.tar.gz
cd etcd-v3.5.9-linux-amd64
sudo mv etcd /usr/local/bin/
sudo mv etcdctl /usr/local/bin/

2.1.2. Windows

访问 etcd releases page。
下载最新的 Windows 版本的 etcd。
解压后，将 etcd 和 etcdctl 二进制文件路径添加到系统的环境变量中。

2.2. 使用 Docker 安装 etcd

你也可以通过 Docker 轻松地运行 etcd：

docker run -d \
  -p 2379:2379 \
  -p 2380:2380 \
  --name etcd \
  --restart always \
  quay.io/coreos/etcd:v3.5.9 \
  /usr/local/bin/etcd \
  --name s1 \
  --data-dir=/var/lib/etcd \
  --listen-client-urls http://0.0.0.0:2379 \
  --advertise-client-urls http://0.0.0.0:2379

3. 启动 etcd

安装完成后，可以通过命令行启动 etcd：

bash 复制代码

etcd

etcd 默认监听 127.0.0.1:2379 端口。

你可以通过 etcdctl 命令行工具与 etcd 交互。它可以执行各种操作，如读写键值、查看集群状态等。

4. etcdctl 基本指令

4.1. 设置环境变量

为简化命令，你可以设置一些环境变量：

export ETCDCTL_ENDPOINTS=127.0.0.1:2379

4.2. 基本操作

如果是docker 容器可能没有安装bash 环境可以采用直接运行容器内部的形式

bash 复制代码

hcy@DESKTOP-VT67UMJ:/mnt/c/Users/侯$ docker exec -it etcd /usr/local/bin/etcdctl put mykey "Hello etcd"
OK
hcy@DESKTOP-VT67UMJ:/mnt/c/Users/侯$ docker exec -it etcd /usr/local/bin/etcdctl get mykey
mykey
Hello etcd

4.2.1. 存储键值对

etcdctl put mykey "Hello, etcd"

4.2.2. 读取键值对

etcdctl get mykey

4.2.3. 删除键值对

etcdctl del mykey

4.2.4. 列出所有键值

 etcdctl get a --from-key --keys-only

4.2.5. 事务操作

etcd 支持原子事务，允许你在一个事务中执行多个操作。

etcdctl txn <<EOF
> cmp("mykey", "value", "=")
> success
>   put("mykey2", "success")
> failure
>   put("mykey3", "failure")
> EOF

4.3. 监控键值变更

你可以通过 watch 命令监控指定键或键的前缀的变更。

etcdctl watch mykey

5. 集群管理

etcd 支持集群模式，允许多个 etcd 实例组成集群来提供高可用性。

5.1. 启动集群

你可以通过以下命令启动一个包含三个节点的 etcd 集群：

etcd --name infra0 --initial-advertise-peer-urls http://127.0.0.1:2380 \
  --listen-peer-urls http://127.0.0.1:2380 \
  --listen-client-urls http://127.0.0.1:2379 \
  --advertise-client-urls http://127.0.0.1:2379 \
  --initial-cluster-token etcd-cluster-1 \
  --initial-cluster infra0=http://127.0.0.1:2380,infra1=http://127.0.0.1:2381,infra2=http://127.0.0.1:2382 \
  --initial-cluster-state new

5.2. 查看集群成员

etcdctl member list

5.3. 增加和删除集群成员

增加成员

etcdctl member add infra3 --peer-urls=http://127.0.0.1:2383

删除成员

etcdctl member remove <memberID>

6. etcd Web UI

为了更方便地管理和监控 etcd，你可以使用 etcd 的 Web UI 插件。

6.1. 安装 etcd Web UI

下载 etcd 的 Web UI 项目，如 etcdkeeper。
运行 etcdkeeper：

git clone https://github.com/evildecay/etcdkeeper
cd etcdkeeper
go run main.go
访问 http://localhost:8080/etcdkeeper/ 来访问 Web UI。

6.2. 通过 Web UI 进行操作

通过 Web UI，你可以：

查看和管理键值对：可以直观地查看、添加、修改、删除 etcd 中的键值对。
监控集群状态：通过图形化界面查看集群状态、健康状况等。

7. 使用 etcd 进行分布式锁

etcd 提供了原子操作和版本控制功能，使得它可以用来实现分布式锁。

7.1. 实现分布式锁

etcdctl lock mylock "echo 'This is a critical section'"

这个命令会创建一个锁，执行命令完成后，锁会自动释放。

7.2. 手动锁和解锁

# 锁定
etcdctl put mylock "locked" --lease=<lease_id>

# 解锁
etcdctl del mylock

8. 高级特性

8.1. 角色管理和权限控制

etcd 支持角色管理和权限控制，以增强安全性。

8.1.1. 创建用户和角色

etcdctl user add root
etcdctl role add root
etcdctl user grant-role root root

8.1.2. 设置权限

etcdctl role grant-permission root --prefix=true readwrite /mykey

8.1.3. 启用认证

etcdctl auth enable

8.2. 使用 etcd 进行配置管理

你可以使用 etcd 存储应用程序的配置，并通过 watch 命令监听配置变更，实时更新应用配置。

etcdctl put /config/app1/database "mysql://user:pass@localhost/db"

你的应用可以通过监听 /config/app1/database 键的变更，自动加载新的配置。