etcd是GaussDB 100引入的第三方软件，能够通过其启动一个分布式键值存储系统，管理来自存储系统的数据。

功能介绍

一个etcd进程管理来自同一个存储系统的数据。一个系统上可以同时运行多个etcd进程，只要使用不同的数据目录和不同的端口号。etcd启动时需要知道数据目录的位置，该位置必须通过-->缺省时etcd在前台启动并将日志信息输出到标准错误。但在实际应用中，etcd应当作为后台进程启动，而且多数是在系统启动时自动启动。

参数说明

etcd参数分为：

常用参数，详细请参见表1。
成员参数，详细请参见表2。
集群参数，详细请参见表3。
代理参数，详细请参见表4，代理参数仅支持ETCD V2的API。
ETCD安全参数，详细请参见表5。
调试参数，主要是便于开发者调试的参数。详细请参见表6。
维护参数，用于在ETCD不可用时集群转换为单机模式运行的参数。详细请参见表7。
分析参数，详细请参见表8。

表1 常用参数
参数	参数说明
--version	显示etcd版本。
-h，--help	显示关于etcd的命令行参数的帮助信息，然后退出。
--config-file	指定服务器配置文件路径。

表2 成员参数
参数	参数说明	取值范围
--name NAME	指定成员名。	缺省是default。
-->DATADIR	指定数据目录。	缺省是${name}.etcd。
--wal-dir WALDIR	指定WAL目录。	-
--snapshot-count SNAPSHOTCOUNT	指定触发做一次snapshot的事务数量。	缺省是10000。
--heartbeat-interval INTERVAL	指定心跳周期。	缺省是100。单位为ms。
--election-timeout TIMEOUT	指定心跳超时时间。	缺省是1000。单位为ms。
--listen-peer-urls URLS	指定侦听其他成员连接的URL。	缺省是http://localhost:2380。
--listen-client-urls URLS	指定侦听客户端连接的URL。	缺省是http://localhost:2379。
--max-snapshots SNAPSHOTS	设置保留快照的最大数量。设置为“0”时，表示无限制。	缺省值是5。
--max-wals WALS	设置保留WAL日志文件数量。设置为“0”时，表示无限制。	缺省值是5。
-cors CORS	指定允许跨域连接的客户端白名单。	-
--quota-backend-bytes BYTES	当后端大小超过给定配额时，引发告警。	缺省值是0。

表3 集群参数
参数	参数说明	取值范围
--initial-advertise-peer-urls URLS	指定侦听其他成员连接的URL。	缺省是http://localhost:2380。
--initial-cluster CLUSTER	指定etcd集群配置。	缺省是http://localhost:2380。
--initial-cluster-state CLUSTERSTATE	指定etcd集群模式。	new：新的集群。 existing：集群已存在。缺省是new。
--initial-cluster-token CLUSTERTOKEN	指定etcd集群标识。指定此选项，在运行多个群集时可避免意外的跨群集交互。	缺省是etcd-cluster。
--advertise-client-urls URLS	指定侦听客户端连接的URL。	缺省是http://localhost:2379。
--discovery DISCOVERY	指定自发现模式启动的URL。	-
--discovery-fallback FALLBACK	指定自发现服务不可用时集群的处理方式。	exit：etcd节点退出。 proxy：etcd节点以代理模式运行。缺省是proxy。
--discovery-proxy PROXY	指定自发现服务的代理。	-
--discovery-srv SRV	指定DNS自发现模式启动的DNS域名。	-
--strict-reconfig-check	用于通过拒绝重新配置请求达到仲裁失败的目的。	-
--auto-compaction-retention RETENTION	每小时自动保留的数据压缩量。0为不自动压缩。	缺省是0。

表4 代理参数
参数	参数说明	取值范围
--proxy PROXYMODE	指定代理模式。	PROXYMODE 可以取以下三个值： off：关闭代理模式。 readonly：打开代理模式，但只能读。 on：打开代理模式，读写皆可。缺省是off。
--proxy-failure-wait FAILUREWAIT	指定代理故障状态下有效时间。	缺省是5000。单位为ms。
--proxy-refresh-interval INTERVAL	指定更新周期。	缺省是30000。单位为ms。
--proxy-dial-timeout TIMEOUT	指定拨号超时时间。	缺省是1000。单位为ms。
--proxy-write-timeout MEOUT	指定写超时时间。	缺省是5000。单位为ms。
--proxy-read-timeout TIMEOUT	指定读超时时间。	缺省是0。单位为ms。

表5 安全参数
参数	参数说明	取值范围
--ca-file PATH	指定客户端TLS CA文件路径。	-
--cert-file PATH	指定客户端TLS cert文件路径。	-
--key-file PATH	指定客户端TLS密钥文件路径。	-
--client-cert-auth AUTH	指定是否支持客户端cert认证。	true：支持客户端cert认证。 false：不支持客户端cert认证。缺省是false。
--trusted-ca-file PATH	指定客户端TLS信任的CA密钥文件路径。	-
-auto-tls TLS	指定客户端是否使用生成的证书。	true：支持客户端cert认证。 false：不支持客户端cert认证。缺省是false。
--peer-ca-file PATH	指定其他成员TLS CA文件路径。	-
--peer-cert-file PATH	指定其他成员TLS cert文件路径。	-
--peer-key-file PATH	指定其他成员TLS密钥文件路径。	-
--peer-client-cert-auth AUTH	指定是否支持其他成员客户端cert认证。	true：支持其他成员cert认证。 false：不支持其他成员cert认证。缺省是false。
--peer-trusted-ca-file PATH	指定其他成员TLS信任的CA密钥文件路径。	-
--peer-auto-tls TLS	指定其他成员是否在未提供TLS密钥文件路径和TLS cert文件路径时，使用自行生成的证书。	true：支持其他成员cert认证。 false：不支持其他成员cert认证。缺省是false。

表6 调试参数
参数	参数说明	取值范围
--debug DEBUG	指定是否打开调试模式。	true：开启日志调试模式。 false：关闭日志调试模式。缺省是false。
--log-package-levels LEVEL	为每个EUCD包指定一个特定的日志级别。	-

表7 维护参数
参数	参数说明	取值范围
--force-new-cluster FORCENEWCLUSTER	指定是否强制创建一个新的集群。	true：强制创建一个新的集群。 false：不强制创建一个新的集群。缺省是false。

表8 分析参数
参数	参数说明	取值范围
--enable-pprof ENABLE	指定是否通过HTTP服务器执行运行时的数据分析。地址为客户端URL+"/debug/pprof"。	true：强制创建一个新的集群。 false：不强制创建一个新的集群。缺省是false。

ITPub博客

etcd-etcd

功能介绍

参数说明

最新文章