• 安装
    • 二进制文件方式下载
    • Docker 镜像方式运行
    • macOS 中运行

    安装

    etcd 基于 Go 语言实现,因此,用户可以从 项目主页 下载源代码自行编译,也可以下载编译好的二进制文件,甚至直接使用制作好的 Docker 镜像文件来体验。

    注意:本章节内容基于 etcd 3.x 版本

    二进制文件方式下载

    编译好的二进制文件都在 github.com/coreos/etcd/releases 页面,用户可以选择需要的版本,或通过下载工具下载。

    例如,使用 curl 工具下载压缩包,并解压。

    1. $ curl -L https://github.com/coreos/etcd/releases/download/v3.2.10/etcd-v3.2.10-linux-amd64.tar.gz -o etcd-v3.2.10-linux-amd64.tar.gz
    2. $ tar xzvf etcd-v3.2.10-linux-amd64.tar.gz
    3. $ cd etcd-v3.2.10-linux-amd64

    解压后,可以看到文件包括

    1. $ ls
    2. Documentation README-etcdctl.md README.md READMEv2-etcdctl.md etcd etcdctl

    其中 etcd 是服务主文件,etcdctl 是提供给用户的命令客户端,其他文件是支持文档。

    下面将 etcd etcdctl 文件放到系统可执行目录(例如 /usr/local/bin/)。

    1. $ sudo cp etcd* /usr/local/bin/

    默认 2379 端口处理客户端的请求,2380 端口用于集群各成员间的通信。启动 etcd 显示类似如下的信息:

    1. $ etcd
    2. 2017-12-03 11:18:34.406082 I | etcdmain: etcd Version: 3.2.10
    3. 2017-12-03 11:18:34.406226 I | etcdmain: Git SHA: GitNotFound
    4. 2017-12-03 11:18:34.406235 I | etcdmain: Go Version: go1.9.2
    5. 2017-12-03 11:18:34.406242 I | etcdmain: Go OS/Arch: darwin/amd64
    6. 2017-12-03 11:18:34.406250 I | etcdmain: setting maximum number of CPUs to 4, total number of available CPUs is 4
    7. 2017-12-03 11:18:34.406265 N | etcdmain: failed to detect default host (default host not supported on darwin_amd64)
    8. 2017-12-03 11:18:34.406279 W | etcdmain: no data-dir provided, using default data-dir ./default.etcd
    9. 2017-12-03 11:18:34.406457 N | etcdmain: the server is already initialized as member before, starting as etcd member...
    10. 2017-12-03 11:18:34.411579 I | embed: listening for peers on http://localhost:2380
    11. 2017-12-03 11:18:34.411938 I | embed: listening for client requests on localhost:2379

    此时,可以使用 etcdctl 命令进行测试,设置和获取键值 testkey: "hello world",检查 etcd 服务是否启动成功:

    1. $ etcdctl member list
    2. 8e9e05c52164694d, started, default, http://localhost:2380, http://localhost:2379
    3. $ etcdctl put testkey "hello world"
    4. OK
    5. $ etcdctl get testkey
    6. testkey
    7. hello world

    说明 etcd 服务已经成功启动了。

    Docker 镜像方式运行

    镜像名称为 quay.io/coreos/etcd,可以通过下面的命令启动 etcd 服务监听到 23792380 端口。

    1. $ export NODE1=192.168.1.21
    2. $ docker run --name etcd \
    3. -p 2379:2379 \
    4. -p 2380:2380 \
    5. --volume=etcd-data:/etcd-data \
    6. quay.io/coreos/etcd:latest \
    7. /usr/local/bin/etcd \
    8. --data-dir=/etcd-data --name node1 \
    9. --initial-advertise-peer-urls http://${NODE1}:2380 --listen-peer-urls http://0.0.0.0:2380 \
    10. --advertise-client-urls http://${NODE1}:2379 --listen-client-urls http://0.0.0.0:2379 \
    11. --initial-cluster node1=http://${NODE1}:2380

    注意:etcd 官方标注 quay.io/coreos/etcd 即将废弃,启用新的 gcr.io/etcd-development/etcd 镜像,但后者由于网络原因,国内不能下载到该镜像,这里仍然使用前者作为演示。

    打开新的终端按照上一步的方法测试 etcd 是否成功启动。

    macOS 中运行

    1. $ brew install etcd
    2. $ etcd
    3. $ etcdctl member list