ToB企服应用市场:ToB评测及商务社交产业平台

标题: docker安装etcd:docker离线安装etcd、docker在线安装etcd、etcd镜像下载、e [打印本页]
作者: 缠丝猫    时间: 前天 05:03
标题: docker安装etcd:docker离线安装etcd、docker在线安装etcd、etcd镜像下载、e


官方网站

官方网址：etcd
二进制包下载：Install | etcd
GitHub社区项目：etcd-io · GitHub
GitHub社区项目版本汗青：Releases · etcd-io/etcd · GitHub

一、镜像下载

1、在线下载

在一台能连外网的linux上实行docker镜像拉取命令
  1. docker pull etcd:3.5.18
复制代码
2、离线包下载

两种方式：
方式一：

-）在一台能连外网的linux上安装docker实行第一步的命令下载镜像
-）导出
  1. # 导出镜像到本地当前目录
  2. docker save -o bitnami_etcd_3_5_18.tar etcd:3.5.18
复制代码
方式二：

-）Window桌面步伐：Docker Desktop

-）下载镜像

-）安装镜像导出插件(分析过程就复用了之前mysql的图)

-）将镜像文件保存到window当地（图略）

3、Community Edition | Docs

Install Etcd on Linux | Docs

官方的下载所在，k8s环境用不上，由于官方没有发布镜像（自行打镜像的除外）


二、安装

1、在线安装

见离线安装（只比离线安装少一步导入动作）
2、离线安装

-）导入镜像

  
  1. docker load -i bitnami_etcd_3_5_18.tar
复制代码
-）检察镜像

  
  1. [docker@GZ***-PM153160 ~]$ docker images
  2. REPOSITORY                                       TAG             IMAGE ID       CREATED         SIZE
  3. bitnami/etcd                                     3.5.18          bdc73d3efea1   4 days ago      190MB
复制代码
-）创建映射目录

创建redis设置文件目录、数据文件目录，并修改目录权限
  
  1. sudo mkdir -p /opt/etcd/docker-etcd/conf
  2. sudo mkdir -p /data1/etcd/docker-etcd/data
  3. sudo mkdir -p /data1/etcd/docker-etcd/log
  4. sudo chown -R docker.docker /opt/etcd
  5. # 作者data1目录下全是docker用户程序数据，所以没有指定子目录
  6. sudo chown -R docker.docker /data1
  7. # sudo chown -R docker.docker /data1/etcd
复制代码
-）启动容器

  
  1. docker run -d \
  2.   --name my-etcd-server5 \
  3.   -v /data1/etcd-data:/data \
  4.   -e "ETCD_ROOT_PASSWORD=iam***#T123" \
  5.   -p 2379:2379 \
  6.   -p 2380:2380 \
  7.   -d bdc73d3efea1
复制代码
这个命令做了以下几件事：

-）检察容器

  
  1. [docker@GZ***-PM153160 ~]$ docker ps
  2. CONTAINER ID   IMAGE                                     COMMAND                  CREATED          STATUS          PORTS                                                                                                                                             NAMES
  3. bc7bbe2026b6   bdc73d3efea1                              "/opt/bitnami/script…"   10 minutes ago   Up 10 minutes   0.0.0.0:12379->2379/tcp, [::]:12379->2379/tcp, 0.0.0.0:12380->2380/tcp, [::]:12380->2380/tcp                                                      ctc-etcd-server5
复制代码
-）从容器内部拷贝设置文件

  
  1. [docker@GZ***-PM153160 ~]$ docker cp db867a1bae9a:/etc/etcd/etcd.conf /opt/etcd/docker-redis/conf/etcd.conf
  2. Successfully copied 1.54kB to /opt/etcd/docker-etcd/conf/etcd.conf
  3. [docker@GZ***-PM153160 ~]$
复制代码
bitnami版（作者当前版本），一般作者不用这个，可作者写文章时下错了，不外不影响读者参考
  1. [docker@GZ***-PM153160 ~]$ docker cp db867a1bae9a:/opt/bitnami/etcd/conf/etcd.conf /opt/etcd/docker-etcd/conf/etcd.conf
  2. Successfully copied 1.54kB to /opt/etcd/docker-etcd/conf/etcd.conf
  3. [docker@GZ***-PM153160 ~]$
复制代码

-）调整其他设置（可选）

vi /opt/etcd/docker-etcd/conf/etcd.conf
按需修改后，删除原容器，添加设置文件映射参数后重新创建容器
  
  1. docker run -d \
  2.   --name my-etcd-server5 \
  3.   -v /data1/etcd-data:/data \
  4.   -e "ETCD_ROOT_PASSWORD=iam***#T123" \
  5.   -p 2379:2379 \
  6.   -p 2380:2380 \
  7.   -d bdc73d3efea1
复制代码
-）重启容器

  
  1. [docker@GZ***-PM153160 ~]$ docker restart bc7bbe2026b6
  2. bc7bbe2026b6
复制代码
三、ETCD设置详解

1、etcd成员相关的设置项

  1. --name 'default'  
  2.   为该成员指定一个易读的名称。
  4. --data-dir '${name}.etcd'  
  5.   数据存储目录的路径。
  7. --wal-dir ''  
  8.   用于存放专用WAL（Write-Ahead Log）的目录路径。
  10. --snapshot-count '100000'  
  11.   触发快照到磁盘的已提交事务数量。
  13. --heartbeat-interval '100'  
  14.   心跳间隔时间（毫秒）。
  16. --election-timeout '1000'  
  17.   选举超时时间（毫秒）。详见调优文档。
  19. --initial-election-tick-advance 'true'  
  20.   是否在启动时加速初始选举计时，从而加快选举速度。
  22. --listen-peer-urls 'http://localhost:2380'  
  23.   用于监听对等节点流量的URL列表。
  25. --listen-client-urls 'http://localhost:2379'  
  26.   用于监听客户端 gRPC 和 HTTP 流量的 URL 列表（当未指定 --listen-client-http-urls 时生效）。
  28. --listen-client-http-urls ''  
  29.   仅用于 HTTP 客户端流量的 URL 列表。启用此标志会将 HTTP 服务从 --listen-client-urls 中移除。
  31. --max-snapshots '5'  
  32.   保留的最大快照文件数量（0表示不限制）。
  34. --max-wals '5'  
  35.   保留的最大WAL文件数量（0表示不限制）。
  37. --quota-backend-bytes '0'  
  38.   当后端大小超过给定配额时触发警报（0表示使用默认低空间配额）。
  40. --backend-bbolt-freelist-type 'map'  
  41.   指定Boltdb后端使用的freelist类型（支持 array 和 map 类型）。
  43. --backend-batch-interval ''  
  44.   提交后端事务前的最大时间间隔。
  46. --backend-batch-limit '0'  
  47.   提交后端事务前的最大操作数。
  49. --max-txn-ops '128'  
  50.   每个事务允许的最大操作数。
  52. --max-request-bytes '1572864'  
  53.   服务器可接受的客户端请求的最大字节数。
  55. --grpc-keepalive-min-time '5s'  
  56.   客户端在发送ping请求前应等待的最短时间间隔。
  58. --grpc-keepalive-interval '2h'  
  59.   服务器向客户端发送ping以检查连接是否存活的频率（0表示禁用）。
  61. --grpc-keepalive-timeout '20s'  
  62.   在关闭无响应连接前的额外等待时间（0表示禁用）。
  64. --socket-reuse-port 'false'  
  65.   启用后允许监听器设置SO_REUSEPORT选项，支持对已使用端口的重新绑定。
  67. --socket-reuse-address 'false'  
  68.   启用后允许监听器设置SO_REUSEADDR选项，支持绑定处于TIME_WAIT状态的地址。
复制代码
2、Etcd集群引导和发现设置参数

  1. --initial-advertise-peer-urls 'http://localhost:2380'  
  2.   向集群中其他成员宣传的该节点的对等节点URL列表。
  4. --initial-cluster 'default=http://localhost:2380'  
  5.   引导时的初始集群配置。
  7. --initial-cluster-state 'new'  
  8.   初始集群状态（'new'表示新集群，'existing'表示已有集群）。
  10. --initial-cluster-token 'etcd-cluster'  
  11.   引导期间用于etcd集群的初始集群令牌。  
  12.   指定该令牌可防止在运行多个集群时出现意外的跨集群交互。
  14. --advertise-client-urls 'http://localhost:2379'  
  15.   向外部公开宣传的该节点的客户端URL列表。  
  16.   这些URL应可供与etcd集群通信的机器访问，etcd客户端库会解析这些URL以连接到集群。
  18. --discovery ''  
  19.   用于集群引导的发现URL。
  21. --discovery-fallback 'proxy'  
  22.   当发现服务失败时的预期行为（'exit'或'proxy'）。  
  23.   'proxy'仅支持v2 API。
  25. --discovery-proxy ''  
  26.   访问发现服务时使用的HTTP代理。
  28. --discovery-srv ''  
  29.   用于引导集群的DNS SRV域。
  31. --discovery-srv-name ''  
  32.   引导时查询的DNS SRV名称后缀。
  34. --strict-reconfig-check 'true'  
  35.   拒绝可能导致法定人数丧失的重新配置请求。
  37. --pre-vote 'true'  
  38.   启用Raft预投票算法，以防止隔离的节点重新加入集群时引发中断。
  40. --auto-compaction-retention '0'  
  41.   自动压缩的保留时长。0表示禁用自动压缩。
  43. --auto-compaction-mode 'periodic'  
  44.   解释'auto-compaction-retention'的模式，可选'periodic'或'revision'。  
  45.   'periodic'表示基于时间的保留，默认单位为小时（如'5m'表示5分钟）。  
  46.   'revision'表示基于修订号的保留。
  48. --enable-v2 'false'  
  49.   接受etcd V2客户端请求。已被弃用，并将在v3.6中移除。
  51. --v2-deprecation 'not-yet'  
  52.   v2存储的弃用阶段。允许选择更高的兼容模式。支持的值：  
  53.     'not-yet'                // 如果v2存储有有效内容，发出警告（v3.5默认值）。  
  54.     'write-only'             // 不允许自定义v2状态（计划在v3.6中默认启用）。  
  55.     'write-only-drop-data'   // 自定义的v2状态将被删除！  
  56.     'gone'                   // v2存储不再维护（计划在v3.7中成为默认值）。
复制代码
3、Etcd安全和TLS设置

  1. --cert-file ''  
  2.   客户端服务器TLS证书文件的路径。
  4. --key-file ''  
  5.   客户端服务器TLS密钥文件的路径。
  7. --client-cert-auth 'false'  
  8.   启用客户端证书认证。  
  9.   建议启用客户端证书认证，以防止未经认证的客户端攻击（例如CVE-2023-44487），特别是在将etcd作为公共服务运行时。
  11. --client-crl-file ''  
  12.   客户端证书吊销列表文件的路径。
  14. --client-cert-allowed-hostname ''  
  15.   客户端证书认证允许的TLS主机名。
  17. --trusted-ca-file ''  
  18.   客户端服务器TLS受信任的CA证书文件路径。  
  19.   设置此参数时，无论`--client-cert-auth`的值如何，都会自动启用客户端证书认证。
  21. --auto-tls 'false'  
  22.   使用自动生成的证书进行客户端TLS认证。
  24. --peer-cert-file ''  
  25.   对等节点服务器TLS证书文件的路径。
  27. --peer-key-file ''  
  28.   对等节点服务器TLS密钥文件的路径。
  30. --peer-client-cert-auth 'false'  
  31.   启用对等节点客户端证书认证。  
  32.   建议启用对等节点证书认证，以防止未经认证的伪造对等节点攻击（例如CVE-2023-44487）。
  34. --peer-trusted-ca-file ''  
  35.   对等节点服务器TLS受信任的CA文件路径。
  37. --peer-cert-allowed-cn ''  
  38.   连接到对等端点时，客户端证书所需的CN（通用名称）。
  40. --peer-cert-allowed-hostname ''  
  41.   对等认证中允许的TLS主机名。
  43. --peer-auto-tls 'false'  
  44.   如果未提供`--peer-key-file`和`--peer-cert-file`，则使用自生成证书进行对等TLS认证。
  46. --self-signed-cert-validity '1'  
  47.   自动生成的客户端和对等节点证书的有效期，单位为年，默认值为1。
  49. --peer-crl-file ''  
  50.   对等节点证书吊销列表文件的路径。
  52. --cipher-suites ''  
  53.   支持的TLS密码套件列表，客户端/服务器和对等节点之间使用（空值将由Go自动填充）。
  55. --cors '*'  
  56.   CORS（跨域资源共享）允许的源列表，逗号分隔（空值或`*`表示允许所有源）。
  58. --host-whitelist '*'  
  59.   如果服务器不安全，HTTP客户端请求中可接受的主机名（空值或`*`表示允许所有主机）。
  61. --tls-min-version 'TLS1.2'  
  62.   etcd支持的最低TLS版本。
  64. --tls-max-version ''  
  65.   etcd支持的最高TLS版本（空值将由Go自动填充）。
复制代码

4、etcd认证相关参数

  1. --auth-token 'simple'  
  2.   指定v3认证的令牌类型及特定选项，特别适用于JWT。格式为"type,var1=val1,var2=val2,..."。  
  3.   可选类型：'simple'或'jwt'。  
  4.   可用变量：  
  5.   - `sign-method`: 指定JWT的签名方法，可选值为 'ES256'、'ES384'、'ES512'、'HS256'、'HS384'、'HS512'、'RS256'、'RS384'、'RS512'、'PS256'、'PS384' 或 'PS512'。  
  6.   - `pub-key`: 指定用于验证JWT的公钥路径。  
  7.   - `priv-key`: 指定用于签署JWT的私钥路径。  
  8.   - `ttl`: 指定JWT令牌的生存时间（TTL）。
  10. --bcrypt-cost 10  
  11.   指定用于哈希认证密码的bcrypt算法的成本/强度。有效值为4到31之间的整数，值越高，计算成本越高，安全性越强。
  13. --auth-token-ttl 300  
  14.   认证令牌的生存时间（TTL），单位为秒。
复制代码

5、etcd性能监控与指标

  1. --enable-pprof 'false'  
  2.   是否启用通过HTTP服务器提供的运行时性能分析数据。  
  3.   地址为客户端URL加上"/debug/pprof/"。
  5. --metrics 'basic'  
  6.   设置导出指标的详细程度。  
  7.   可选值：  
  8.   - `basic`: 导出基本指标。  
  9.   - `extensive`: 包括服务器端gRPC直方图指标在内的详细指标。
  11. --listen-metrics-urls ''  
  12.   用于监听指标和健康检查端点的URL列表。
复制代码
6、etcd日志设置

  1. --logger 'zap'  
  2.   当前仅支持使用'Zap'进行结构化日志记录。
  4. --log-outputs 'default'  
  5.   指定日志输出目标。  
  6.   - 可以使用'stdout'或'stderr'来跳过`journald`日志（即使在`systemd`下运行）。  
  7.   - 也可以提供逗号分隔的输出目标列表。
  9. --log-level 'info'  
  10.   配置日志级别。支持的级别包括：  
  11.   - `debug`: 调试信息。  
  12.   - `info`: 普通信息。  
  13.   - `warn`: 警告信息。  
  14.   - `error`: 错误信息。  
  15.   - `panic`: 崩溃信息。  
  16.   - `fatal`: 致命错误信息。
  18. --enable-log-rotation 'false'  
  19.   是否启用日志轮转，仅适用于单个日志输出文件。
  21. --log-rotation-config-json '{"maxsize": 100, "maxage": 0, "maxbackups": 0, "localtime": false, "compress": false}'  
  22.   配置日志轮转（启用时生效）。  
  23.   - `maxsize`: 单个日志文件的最大大小（单位：MB）。  
  24.   - `maxage`: 日志文件的最大保留天数（0表示不限制）。  
  25.   - `maxbackups`: 最大备份数量（0表示不限制）。  
  26.   - `localtime`: 是否使用本地时间。  
  27.   - `compress`: 是否启用gzip压缩。
复制代码
Etcd 启动重要参数汇总表

分类参数作用备注节点设置--name设置节点名称，必须唯一。确保集群中节点识别准确。--data-dir指定数据存储目录。用于持久化存储etcd数据。集群设置--initial-advertise-peer-urls设置对等节点的广告URL。集群内节点间通信所在。--listen-peer-urls设置对等节点的监听URL。监听集群内部通信流量。--listen-client-urls设置客户端访问的监听URL。客户端毗连etcd的入口。--initial-cluster设置初始集群成员列表。启动新集群时必需。--initial-cluster-state指定集群状态（new或existing）。新建或加入已有集群时使用。--initial-cluster-token设置集群唯一标识符。防止跨集群的不测交互。安全设置--cert-file / --key-file设置TLS证书和密钥文件。启用加密通信。--client-cert-auth启用客户端证书认证。增强安全性，防止未经认证访问。--trusted-ca-file设置受信任的CA证书路径。验证客户端和对等节点证书。--peer-client-cert-auth启用对等节点证书认证。提高集群安全性。--peer-trusted-ca-file设置对等节点的CA证书路径。对等通信的信任链验证。性能调优--heartbeat-interval设置心跳间隔时间（毫秒）。影响集群同步速度和稳定性。--election-timeout设置选举超时时间（毫秒）。影响Raft选举速度。--snapshot-count设置触发快照的事务数。控制快照频率，平衡性能与存储。--max-txn-ops设置每个事务允许的最大操作数。防止事务过大影响性能。认证与访问控制--auth-token指定认证令牌范例。支持simple和jwt范例。--auth-token-ttl设置认证令牌的有效时间（秒）。控制令牌过期时间。日志管理--logger设置日志记录方式。当前仅支持zap。--log-level设置日志级别。支持debug、info、warn等。--log-outputs设置日志输出目标。可指定stdout、stderr或文件路径。调试与监控--enable-pprof启用性能分析。通过/debug/pprof/访问性能数据。--metrics设置导出指标的详细水平。支持basic和extensive。 分析：


四、常用/根本操作

1. 毗连到etcd集群


  1. etcdctl --endpoints=127.0.0.1:2379,127.0.0.2:2379 get /
复制代码

  1. etcdctl --endpoints=https://127.0.0.1:2379 --cert-file=cert.pem --key-file=key.pem --ca-file=ca.pem get /
复制代码
2. 根本操作


  1. etcdctl get <key> [<range_end>]
复制代码

  1. etcdctl put <key> <value>
复制代码

  1. etcdctl del <key> [<range_end>]
复制代码

  1. etcdctl watch <key>
复制代码
3. 高级操作


  1. etcdctl get --prefix /myapp/
复制代码

  1. etcdctl get --limit=10 /myapp/
复制代码

  1. etcdctl get --rev=10 /myapp/config
复制代码

  1. etcdctl get --keys-only /myapp/
复制代码

  1. etcdctl get --sort-by=key /myapp/
复制代码
4. 集群管理


  1. etcdctl member list
复制代码

  1. etcdctl member add <member_name>
复制代码

  1. etcdctl member remove <member_id>
复制代码

  1. etcdctl snapshot save snapshot.db
复制代码
5. 其他有效选项


  1. etcdctl --debug get /myapp/config
复制代码

  1. etcdctl --timeout=5 get /myapp/config
复制代码

  1. etcdctl --hex get /myapp/config
复制代码
五、遇到的问题总结

1、将镜像推到内网镜像仓库时报错

  
  1. [zhao****@GZ***-PM153160 ~]$ docker push 10.130.***.106:30089/library/zookeeper:3.9.3
  2. The push refers to repository [10.130.153.***:30089/library/zookeeper]
  3. Get "https://10.130.153.***:30089/v2/": x509: cannot validate certificate for 10.130.153.*** because it doesn't contain any IP SANs
复制代码
 解决：换成域名
  
  1. [zhao***@GZ***-PM153160 ~]$ docker login harbor.***.com:30089
  2. Username: admin
  3. Password:
  4. WARNING! Your password will be stored unencrypted in /home/zhaozheng/.docker/config.json.
  5. Configure a credential helper to remove this warning. See
  6. https://docs.docker.com/engine/reference/commandline/login/#credential-stores
  8. Login Succeeded
复制代码
2、启动报failed to start member

  1. etcdserver: start member f3e5d1ce6bfb3bd6 failed to start member hello on ID f3e5d1ce6bfb3bd6, the member ID is generated from URL and seems conflicting with other members, make sure the URL is unique and this is not a re-start script for removing member
复制代码
报错问题表明：

这个错误通常发生在实验以相同的URL重新启动一个已经在集群中的ETCD节点时。当你在集群中已经有了一个具有相同URL的成员时，再次实验使用相同的URL初始化或启动一个成员会导致辩说。
解决方法：


  1. # 首先确保etcdctl指向正确的etcd服务器
  2. export ETCDCTL_API=3
  3. etcdctl --endpoints=http://localhost:2379 member list
  4. etcdctl --endpoints=http://localhost:2379 member remove <member-id>
复制代码

  1. docker run -d --name etcd-server \
  2.   -p 2379:2379 -p 2381:2380 \  # 注意端口号的变化以避免冲突
  3.   quay.io/coreos/etcd:latest etcd --name s1 --initial-advertise-peer-urls http://localhost:2381 --listen-peer-urls http://0.0.0.0:2381 --listen-client-urls http://0.0.0.0:2379 --advertise-client-urls http://localhost:2379 --initial-cluster-token etcd-cluster-1 --initial-cluster s1=http://localhost:2381 --initial-cluster-state new
复制代码

六、可能会用到的其他命令

-）创建卷

  
  1. docker volume create etcd_data
复制代码
-）验证卷

  
  1. docker volume ls
复制代码
-）使用卷

  
  1. docker run --name some-redis -v etcd_data:/data -d etcd:tag
复制代码
 这种docker卷作者没有效过(现实数据存储位置是docker默认数据目录，默认数据目录可以在docker设置文件中设置修改)，有爱好的可自行实验～

假如喜欢我的文章，请帮我点赞，谢谢～  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。



欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/) Powered by Discuz! X3.4