Etcd 配置详解

最新推荐文章于 2024-03-17 16:45:53 发布
最新推荐文章于 2024-03-17 16:45:53 发布
阅读量5.5k 收藏 14
点赞数 1
分类专栏： 『RHCA-OpenS&K8S 』
原文链接：https://cloud.tencent.com/developer/article/1529219
版权

配置标记

etcd 可以通过命令行标记和环境变量来配置。命令行上设置的选项优先于环境变量。

对于标记 --my-flag 环境变量的格式是 ETCD_MY_FLAG。 适用于所有标记。

正式的ectd端口 是 2379 用于客户端连接，而 2380 用于伙伴通讯。etcd 端口可以设置为接受 TLS 通讯，non-TLS 通讯，或者同时有 TLS 和 non-TLS 通讯。

为了在 linux 启动试使用自定义设置自动启动 etcd ，强烈推荐使用 systemd单元。

成员标记

—name

  • 成员的可读性的名字.
  • 默认: “default”
  • 环境变量: ETCD_NAME
  • 这个值被作为这个节点自己的入口中被引用， 在 --initial-cluster 标记(例如, default=http://localhost:2380)中列出。如果使用 static bootstrapping,这需要匹配在标记中使用的key。当使用发现时，每个成员必须有唯一名字。Hostname 或 machine-id 可以是一个好选择。

—data-dir

  • 到数据目录的路径.
  • 默认: “${name}.etcd”
  • 环境变量: ETCD_DATA_DIR

—wal-dir

  • 到专用的 wal 目录的路径。如果这个标记被设置，etcd将写 WAL 文件到 walDIR 而不是 dataDIR。这容许使用专门的硬盘，并帮助避免日志和其他IO操作之间的IO竞争。
  • 默认: “”
  • 环境变量: ETCD_WAL_DIR

—snapshot-count

  • 触发快照到硬盘的已提交事务的数量.
  • 默认: “10000”
  • 环境变量: ETCD_SNAPSHOT_COUNT

—heartbeat-interval

  • 心跳间隔时间 (单位 毫秒).
  • 默认: “100”
  • 环境变量: ETCD_HEARTBEAT_INTERVAL

—election-timeout

  • 选举的超时时间(单位 毫秒). 阅读 Documentation/tuning.md 得到更多详情.
  • 默认: “1000”
  • 环境变量: ETCD_ELECTION_TIMEOUT

—listen-peer-urls

用于监听伙伴通讯的URL列表。这个标记告诉 etcd 在特定的 scheme://IP:port 组合上从它的伙伴接收进来的请求。scheme 可是 http 或者 https。如果IP被指定为0.0.0.0,etcd 在所有接口上监听给定端口。如果给定IP地址和端口，etcd 将监听在给定端口和接口上。多个URL可以用来指定多个地址和端口来监听。etcd将从任何列出来的地址和端口上应答请求。

—listen-client-urls

用于监听客户端通讯的URL列表。这个标记告诉 etcd 在特定的 scheme://IP:port 组合上从客户端接收进来的请求。scheme 可是 http 或者 https。如果IP被指定为 0.0.0.0,etcd 在所有接口上监听给定端口。如果给定IP地址和端口，etcd 将监听在给定端口和接口上。多个 URL 可以用来指定多个地址和端口来监听。etcd 将从任何列出来的地址和端口上应答请求。

—max-snapshots

  • 保持的快照文件的最大数量 (0 表示不限制)
  • 默认: 5
  • 环境变量: ETCD_MAX_SNAPSHOTS
  • 对于 windows 用户默认不限制，而且推荐手工降低到5（或者某些安全偏好)。

—max-wals

  • 保持的 wal 文件的最大数量 (0 表示不限制)
  • 默认: 5
  • 环境变量: ETCD_MAX_WALS
  • 对于windows用户默认不限制，而且推荐手工降低到5（或者某些安全偏好)。

—cors

  • 逗号分割的 origin 白名单，用于 CORS (cross-origin resource sharing/跨 origin 资源共享).
  • 默认: none
  • 环境变量: ETCD_CORS

集群标记

--initial 前缀标记用于启动(static bootstrap, [discovery-service bootstrap])(clustering.md#discovery) 或 runtime reconfiguration) 新成员, 然后当重新启动一个已有的成员时被忽略。

--discovery 前缀标记在使用发现服务需要设置.

—initial-advertise-peer-urls

列出这个成员的伙伴 URL 以便通告给集群的其他成员。这些地方用于在集群中通讯 etcd 数据。至少有一个必须对所有集群成员可以路由的。这些 URL 可以包含域名。

—initial-cluster

为启动初始化集群配置。

  • 默认: “default=http://localhost:2380“
  • 环境变量: ETCD_INITIAL_CLUSTER
  • key是每个提供的节点的 --name 标记的值. 默认为这个 key 使用 default 因为这是 --name 标记的默认值.

—initial-cluster-state

初始化集群状态(“new” or “existing”)。在初始化静态(initial static)或者 DNS 启动 (DNS bootstrapping) 期间为所有成员设置为 new 。如果这个选项被设置为 existing , etcd 将试图加入已有的集群。如果设置为错误的值，etcd 将尝试启动但安全失败。

  • 默认: “new”
  • 环境变量: ETCD_INITIAL_CLUSTER_STATE

—initial-cluster-token

在启动期间用于 etcd 集群的初始化集群记号(cluster token)。

  • 默认: “etcd-cluster”
  • 环境变量: ETCD_INITIAL_CLUSTER_TOKEN

—advertise-client-urls

列出这个成员的客户端URL，通告给集群中的其他成员。这些 URL 可以包含域名。

小心，如果来自集群成员的通告 URL 比如 http://localhost:2379 正在使用 etcd 的 proxy 特性。这将导致循环，因为代理将转发请求给它自己直到它的资源(内存，文件描述符)最终耗尽。

—discovery

用于启动集群的发现URL。

  • 默认: none
  • 环境变量: ETCD_DISCOVERY

—discovery-srv

用于启动集群的 DNS srv 域名。

  • 默认: none
  • 环境变量: ETCD_DISCOVERY_SRV

—discovery-fallback

当发现服务失败时的期待行为(“exit” 或 “proxy”). “proxy” 仅支持 v2 API.

  • 默认: “proxy”
  • 环境变量: ETCD_DISCOVERY_FALLBACK

—discovery-proxy

用于请求到发现服务的 HTTP 代理。

  • 默认: none
  • 环境变量: ETCD_DISCOVERY_PROXY

—strict-reconfig-check

拒绝将导致法定人数丢失的重配置请求。

  • 默认: false
  • 环境变量: ETCD_STRICT_RECONFIG_CHECK

—auto-compaction-retention

自动压缩用于 mvcc 键值存储的保持力(注：应该指多版本保存)，单位小时。 0 表示关闭自动压缩。

  • 默认: 0
  • 环境变量: ETCD_AUTO_COMPACTION_RETENTION

注： 对于服务注册等只保存运行时动态信息的场合，建议开启。完全没有理由损失存储空间和效率来保存之前的版本信息。推荐设置为1,每小时压缩一次。

Proxy flags

--proxy 前缀标记配置 etcd 以 代理模式 运行. “proxy” 仅支持 v2 API.

—proxy

代理模式设置(“off”, “readonly” or “on”).

  • 默认: “off”
  • 环境变量: ETCD_PROXY

—proxy-failure-wait

在被重新考虑之前，终端将被视为失败状态的时间(单位 毫秒)，用于被代理的请求。

  • 默认: 5000
  • 环境变量: ETCD_PROXY_FAILURE_WAIT

—proxy-refresh-interval

终端刷新间隔时间(单位 毫秒)

  • 默认: 30000
  • 环境变量: ETCD_PROXY_REFRESH_INTERVAL

—proxy-dial-timeout

请求的拨号(dial)超时时间(单位 毫秒)，或者 0 禁用超时。

  • 默认: 1000
  • 环境变量 ETCD_PROXY_DIAL_TIMEOUT

—proxy-write-timeout

写操作的超时时间(单位 毫秒)，或者 0 禁用超时。

  • 默认: 5000
  • 环境变量: ETCD_PROXY_WRITE_TIMEOUT

—proxy-read-timeout

读操作的超时时间(单位 毫秒)，或者 0 禁用超时。

不要修改这个值，如果在使用 watch，因为 watch 将使用 long polling 请求。

  • 默认: 0
  • 环境变量: ETCD_PROXY_READ_TIMEOUT

安全标记

安全标记用于帮助 搭建安全 etcd 集群.

—ca-file [弃用]

客户端服务器 TLS 证书文件的路径。--ca-file ca.crt 可以被 --trusted-ca-file ca.crt --client-cert-auth 替代，而 etcd 同样工作。

  • 默认: none
  • 环境变量: ETCD_CA_FILE

—cert-file

客户端服务器 TLS 证书文件的路径。

  • 默认: none
  • 环境变量: ETCD_CERT_FILE

—key-file

客户端服务器 TLS key 文件的路径。

  • 默认: none
  • 环境变量: ETCD_KEY_FILE

—client-cert-auth

开启客户端证书认证。

  • 默认: false
  • 环境变量: ETCD_CLIENT_CERT_AUTH

—trusted-ca-file

客户端服务器 TLS 信任证书文件的路径。

  • 默认: none
  • 环境变量: ETCD_TRUSTED_CA_FILE

—auto-tls

使用生成证书的客户端 TLS。

  • 默认: false
  • 环境变量: ETCD_AUTO_TLS

—peer-ca-file [弃用]

peer server TLS 证书文件的路径. --peer-ca-file ca.crt 可以被 --peer-trusted-ca-file ca.crt --peer-client-cert-auth 替代，而 etcd 同样工作.

  • 默认: none
  • 环境变量: ETCD_PEER_CA_FILE

—peer-cert-file

peer server TLS 证书文件的路径.

  • 默认: none
  • 环境变量: ETCD_PEER_CERT_FILE

—peer-key-file

peer server TLS key 文件的路径.

  • 默认: none
  • 环境变量: ETCD_PEER_KEY_FILE

—peer-client-cert-auth

开启 peer client 证书验证.

  • 默认: false
  • 环境变量: ETCD_PEER_CLIENT_CERT_AUTH

—peer-trusted-ca-file

peer server TLS 信任证书文件路径.

  • 默认: none
  • 环境变量: ETCD_PEER_TRUSTED_CA_FILE

—peer-auto-tls

使用生成证书的peer TLS。

  • 默认: false
  • 环境变量: ETCD_PEER_AUTO_TLS

日志标记

—debug

设置所有子包的默认日志级别为 DEBUG

  • 默认: false (所有包为 INFO)
  • 环境变量: ETCD_DEBUG

—log-package-levels

设置个人 etcd 子包为指定日志级别。例如 etcdserver=WARNING,security=DEBUG

  • 默认: none (所有包为 INFO)
  • 环境变量: ETCD_LOG_PACKAGE_LEVELS

不安全的标记

请谨慎使用不安全标记，因为它将打破一致性协议提供的保证。

例如，它可能惊慌，如果集群中的其他成员还活着。

当使用这些标记时，遵循操作指南。

—force-new-cluster

强制创建新的单一成员的集群。它提交配置修改来强制移除集群中的所有现有成员然后添加自身。当 restore a backup 时需要设置。

  • 默认: false
  • 环境变量: ETCD_FORCE_NEW_CLUSTER

其他标记

—version

打印版本并退出.

  • 默认: false

—config-file

从文件中装载服务器配置.

  • 默认: none

分析标记

—enable-pprof

通过 HTTP 服务器开启运行时分析数据。地址是 client URL + “/debug/pprof/“

  • 默认: false

—metrics

  • 为导出的度量，设置详情的等级，指定 ‘extensive’ 来包含柱状图
  • 默认: basic
Mr. Sun_
关注
  • 1
    点赞
  • 踩
  • 14
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
专栏目录
微服务etcd配置中心.zip
08-17
微服务etcd配置中心
goconfigure:通过 env 或 etcd 配置服务
07-05
弃用的用户 goconfigure - Go 库以从不同来源获取配置 介绍 Golang 配置解析器通过以下方式： 环境评价 等 JSON YAML 旗帜 动物园管理员 领事 例子 etcdClient := etcd.NewClient([]string{"http://127.0.0.1:4001"}) config := goconfigure.Config{ Etcd: goconfigure.Etcd{ Client: etcdClient, Namespace: "goconfigure", }, } config.Add("database_url", "Use etcd for configuration.", "user=ayerra dbname=goconfigure_example
Etcd 介绍与使用（入门篇）
最新发布
热爱数据库的小胖
03-17 1630
etc （基于 Go 语言实现，）在 Linux 系统中是配置文件目录名；etcd 就是配置服务；etcd 诞生于 CoreOS 公司，最初用于解决集群管理系统中 os 升级时的分布式并发控制、配置文件的存储与分发等问题。基于此，etcd 设计为提供高可用、强一致性的小型** kv 数据存储**服务。项目当前隶属于 CNCF 基金会，被包括 AWS、Google、Microsoft、Alibaba 等大型互联网公司广泛使用；
etcd-v3.5.9
07-04
etcd 3.5.9
config-etcd:使用 etcd 配置您的应用
07-05
配置etcd 使用简单的 API 使用来自 etcd 的值配置您的应用程序。 特征 获取 etcd 密钥以配置您的应用程序 让 etcd 指令与其他配置放在一起供以后查找 递归评估一个结构，寻找从 etcd 检索值的指令 回调保证在配置更新后执行 就地配置更新 适用于任何配置方法 安装 npm install config-etcd --save 用 使用您想要将配置值获取到应用程序中的任何方法。 （我更喜欢）。 假设 etcd 键/services/db/password包含值foobar 。 var config = { 'db' : { 'host' : '127.0.0.1' , 'port' : 12345 , 'password' : 'etcd:/services/db/password' } } va
ETCD启动参数配置详解
会哭的雨@的博客
10-17 1万+
cat > /usr/lib/systemd/system/etcd.service <<EOF [Unit] Description=Etcd Server After=network.target After=network-online.target Wants=network-online.target [Service] Type=notify EnvironmentFile=/opt/etcd/cfg/etcd ExecStart=/opt/etcd/bin/etcd \..
etcd构建高可用集群的三种形式
Nicholas的专栏
06-01 4169
etcd构建自身高可用集群主要有三种形式: 静态发现: 预先已知etcd集群中有哪些节点，在启动时通过--initial-cluster参数直接指定好etcd的各个节点地址。 etcd动态发现: 通过已有的etcd集群作为数据交互点，然后在扩展新的集群时实现通过已有集群进行服务发现的机制。比如官方提供的：discovery.etcd.io DNS动态发现: 通过DNS查询方式获取其他节点地址信息。 静态发现： 这里将部署一个3节点的集群， 以下为3台主机信息， 节点名称 地址 et.
微服务自动化之etcd集群搭建
m0_53151031的博客
03-01 2029
目录 一、etcd集群搭建 一、etcd构建自身高可用集群的几种形式 1、静态发现: 2、etcd动态发现 3、DNS动态发现 二、静态部署 三、集群搭建 1、安装服务 2、编辑etcd.conf文件，添加集群信息注意修改对应的ip 3、修改/etc/etcd/etcd.conf文件后，要先删除/var/lib/etcd目录下保存的数据，再重新启用服务，不然失败 4、为节点etcd01创建一个etcd服务 ...
ETCD使用中需要注意的问题--自动压缩--最大字节数--存储数据大小
一名数据库爱好者的专栏
08-19 617
我们在实际生产中使用ETCD存储元数据，　起初集群规模不大的时候元数据信息不多没有发现什么问题。随着集群规模越来越大问题逐渐暴露了有些实际的配置还是需要在初始化的时候就研究确定。
etcd初始化集群
土豆
02-03 1439
准备条件 2台linux系统的虚拟机作etcd集群节点，其ip地址能够互相ping通（本文使用的镜像为：CentOS-8.2.2004-x86_64-minimal.iso） 集群节点分别安装好etcd服务（本文使用的rpm包为：etcd-3.2.21-2.el8.x86_64.rpm） 创建集群 配置文件的修改 etcd集群的创建通过修改配置文件/etc/etcd/etcd.conf实现，修改项主要包括 1.ETCD_DATA_DIR ...
二进制部署kubernetes 1.25.5（二）
zhangkangren的博客
01-11 237
二进制部署kubernetes 1.25.5
etcd manager
05-24
etcd manager
k8s 二进制部署之部署 Etcd 集群
菜鸟厚非
08-17 1万+
Etcd 是一个分布式键值存储系统，Kubernetes使用Etcd进行数据存储，所以先准备一个Etcd数据库，为解决Etcd单点故障，应采用集群方式部署，这里使用3台组建集群，可容忍1台机器故障，当然，你也可以使用5台组建集群，可容忍2台机器故障。 为了节省机器，这里与K8s节点机器复用。也可以独立于k8s集群之外部署，只要apiserver能连接到就行。 节点规划 生成 Etcd 证书 准备cfssl证书生成工具 ......
etcd集群日常维护
lyk-ops
09-27 309
配置文件和启动参数说明 命令行 | 配置文件 | 说明 data-dir | ETCD_DATA_DIR | 指定节点的数据存储目录，包括节点ID，集群ID，集群初始化配置，Snapshot...
实战操作-介绍 ETCD 部署两种形式
Kubernetes云计算的专栏
08-10 1473
实战操作-介绍 ETCD 部署两种形式 1. 二进制部署 本文着重介绍集群采用二进制包安装 etcd 。以 etcd-v3.3.15为例。 假设： etcd1：10.16.11.180 etcd2：10.16.11.182 etcd3：10.16.11.181 三台主机从官方下载的发行版二进制包，手动部署，组成kubernetes etcd集群。 1.1 以下三台主机操作 #关闭防火墙 #systemctl stop firewalld #systemctl di.
Etcd集群的搭建以及分析
m0_37997046的博客
11-10 1万+
etcd的架构 从 etcd 的架构图中我们可以看到，etcd 主要分为四个部分。 HTTP Server： 用于处理用户发送的 API 请求以及其它 etcd 节点的同步与心跳信息请求。 Store：用于处理 etcd 支持的各类功能的事务，包括数据索引、节点状态变更、监控与反馈、事件处理与执行等等，是 etcd 对用户提供的大多数 API 功能的具体实现。 Raft：Raft 强一致性算法...
Docker搭建etcd集群（亲测）
桂安俊@KylinOS
03-29 3647
笔者测试环境为Centos7.5 64bit 1、容器安装etcd #yum install etcd -y//centos7的镜像直接用yum安装即可 #etcd -version //进入容器查看etcd版本，是否安装成功 2、Etcd部署 2.1、开放etcd通信使用的接口 #firewall-cmd --zone=public --add...
Etcd的启动配置参数详解
热门推荐
胡伟煌的博客
05-07 1万+
目录： 1. Etcd配置参数 1.1. member flags 1.2. clustering flags 1.3. proxy flags 1.4. security flags 1.5. logging flags 1.6. unsafe flags 1.7. profiling flags 1.8. auth flags 1.9. experimental flags ...
ETCD 压缩调优配置
su_ren的博客
07-08 2370
应用场景： etcd有默认的存储空间。官方推荐2个g，可以配置到8个g。这个空间用来存储etcd的key-value。 etcd的存储方式： etcd对一个key的操作是 append，对一个key的操作，是一个增加版本号的操作，存储起来。然后对这些key根据版本号压缩。 一个trick，etcd可以访问历史数据（在被压缩之前） etcd的压缩： 压缩有两种方式： 按时间段来（配置开启，periodic）： 每1/10个配置的时间段，执行一次压缩，压缩的数据是1/10个小时计算的。 按
go 读取etcd配置
08-30
etcd是一个高可用的分布式键值存储系统，常用于共享配置信息。如果想要使用go语言读取etcd配置，需要使用etcd的go客户端库。 首先，我们需要在go项目中导入etcd的go客户端库，可以使用如下命令安装： go get github.com/coreos/etcd/clientv3 然后，在代码中引入所需的包： import ( "context" "fmt" "go.etcd.io/etcd/clientv3" "time" ) 接下来，我们需要创建etcd的客户端连接： func main() { cli, err := clientv3.New(clientv3.Config{ Endpoints: []string{"http://127.0.0.1:2379"}, // etcd的地址 DialTimeout: 5 * time.Second, // 连接超时时间 }) if err != nil { fmt.Println("连接etcd失败：", err) return } defer cli.Close() } 接着，我们可以通过客户端连接读取etcd中的配置信息。例如，假设我们要读取一个名为"config"的配置项： resp, err := cli.Get(context.Background(), "config") if err != nil { fmt.Println("读取配置失败：", err) return } for _, ev := range resp.Kvs { fmt.Printf("Key: %s, Value: %s\n", ev.Key, ev.Value) } 在这个例子中，我们使用cli.Get()方法来获取指定key的配置项。然后，通过遍历resp.Kvs来获取具体的key和value。 最后，记得在程序结束前关闭etcd的客户端连接： defer cli.Close() 以上就是使用go语言读取etcd配置的基本步骤。希望对你有帮助！

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值