ETCD命令行标志和环境变量配置参数

546 阅读6分钟

这是我参与更文挑战的第17天,活动详情查看: 更文挑战

Member flags

flag说明默认值环境变量
–name这个成员的可读名称defaultETCD_NAME
–data-dir数据目录${name}.etcdETCD_DATA_DIR
–wal-dir专用wal目录的路径。如果这个标志被设置,etcd会将WAL文件写入walDir而不是dataDir。这允许使用专用磁盘,并有助于避免记录和其他IO操作之间的竞争””ETCD_WAL_DIR
–snapshot-count触发快照到磁盘的已提交事务数100000ETCD_SNAPSHOT_COUNT
–heartbeat-interval心跳间隔的时间(以毫秒为单位)100ETCD_HEARTBEAT_INTERVAL
–election-timeout选举超时的时间(以毫秒为单位)1000ETCD_ELECTION_TIMEOUT
–listen-peer-urls要监听对等流量的URL列表。该标志告诉etcd接受来自指定方案的对等方的传入请求scheme://IP:port 组合。Scheme可以是http或https。如果将0.0.0.0指定为IP,则etcd会侦听所有接口上的给定端口。如果给出了一个IP地址和一个端口,etcd将监听给定的端口和接口。可以使用多个URL来指定要侦听的多个地址和端口。etcd将响应来自任何列出的地址和端口的请求。http://localhost:2380,http://localhost:7001”ETCD_LISTEN_PEER_URLS
–listen-client-urls要监听客户端流量的URL列表。该标志告诉etcd接受来自指定方案的客户端的传入请求scheme://IP:port组合。Scheme可以是http或https。如果将IP指定为0.0.0.0,则etcd会侦听所有接口上的给定端口。如果给出了一个IP地址和一个端口,etcd将监听给定的端口和接口。可以使用多个URL来指定要侦听的多个地址和端口。etcd将响应来自任何列出的地址和端口的请求。http://localhost:2379,http://localhost:4001”ETCD_LISTEN_CLIENT_URLS
–max-snapshots要保留的最大快照文件数(0无限制)[Windows用户的默认值是无限的,建议手动清除至5]5ETCD_MAX_SNAPSHOTS
–max-wals要保留的最大wal文件数量(0无限制)[Windows用户的默认值是无限的,建议手动清除至5]5ETCD_MAX_WALS
–cors用逗号分隔的CORS起源白名单(跨源资源共享)noneETCD_CORS

Clustering flags

–initial前缀标志用于引导(静态引导,发现服务引导或运行时重新配置)新成员,并在重新启动现有成员时被忽略。 –discovery在使用发现服务时需要设置前缀标志

flag说明默认值环境变量
–initial-advertise-peer-urls此成员的对等URL列表以通告给群集的其余部分。这些地址用于在群集周围传送etcd数据。至少有一个必须可路由到所有集群成员。这些URL可以包含域名。http://localhost:2380,http://localhost:7001”ETCD_INITIAL_ADVERTISE_PEER_URLS
–initial-cluster引导的初始群集配置。“default=http://localhost:2380, default=http://localhost:7001”ETCD_INITIAL_CLUSTER
–initial-cluster-state初始群集状态 (“new” or “existing”)。设置new为在初始静态或DNS自举期间存在的所有成员。如果此选项设置为existing,则etcd将尝试加入现有群集。如果设置了错误的值,etcd将尝试启动但安全失败。“new”ETCD_INITIAL_CLUSTER_STATE
–initial-cluster-token在引导期间,用于etcd集群的初始群集令牌。“etcd-cluster”ETCD_INITIAL_CLUSTER_TOKEN
–advertise-client-urls此成员的客户端URL列表以通告给群集的其余部分。这些URL可以包含域名。http://localhost:2379,http://localhost:4001”ETCD_ADVERTISE_CLIENT_URLS
–discovery用于引导群集的发现URL。noneETCD_DISCOVERY
–discovery-srv用于引导群集的DNS srv域。noneETCD_DISCOVERY_SRV
–discovery-fallback发现服务失败时的预期行为 (“exit” or “proxy”)。“proxy”ETCD_DISCOVERY_FALLBACK
–discovery-proxy用于流量发现服务的HTTP代理。noneETCD_DISCOVERY_PROXY
–strict-reconfig-check拒绝会导致法定人数丢失的重新配置请求falseETCD_STRICT_RECONFIG_CHECK

Proxy Flags

–proxy前缀标志配置etcd以代理模式运行。

flag说明默认值环境变量
–proxy代理模式设置 (“off”, “readonly” or “on”).offETCD_PROXY
–proxy-failure-wait在重新考虑代理请求之前,时间(以毫秒为单位),端点将保持失败状态。5000ETCD_PROXY_FAILURE_WAIT
–proxy-refresh-interval端点刷新间隔的时间(以毫秒为单位)。30000ETCD_PROXY_REFRESH_INTERVAL
–proxy-dial-timeout拨号超时的时间(毫秒)或禁用超时的时间(以毫秒为单位)1000ETCD_PROXY_DIAL_TIMEOUT
–proxy-write-timeout写入超时的时间(毫秒)或禁用超时的值为05000ETCD_PROXY_WRITE_TIMEOUT
–proxy-read-timeout读取超时的时间(以毫秒为单位)或0以禁用超时。0ETCD_PROXY_READ_TIMEOUT

Security Flags

安全标志有助于构建安全的etcd集群

flag说明默认值环境变量
–ca-file[弃用]客户端服务器TLS CA文件的路径。–ca-file ca.crt可以被替换–trusted-ca-file ca.crt –client-cert-auth和etcd将执行相同的操作noneETCD_CA_FILE
–cert-file客户端服务器TLS证书文件的路径。noneETCD_CERT_FILE
–key-file客户端服务器TLS密钥文件的路径。noneETCD_KEY_FILE
–client-cert-auth启用客户端证书认证。falseETCD_CLIENT_CERT_AUTH
–trusted-ca-file客户端服务器的路径TLS可信CA密钥文件。noneETCD_TRUSTED_CA_FILE
–peer-ca-file[弃用]对等服务器TLS CA文件的路径。–peer-ca-file ca.crt可以被替换–peer-trusted-ca-file ca.crt –peer-client-cert-auth和etcd将执行相同的操作noneETCD_PEER_CA_FILE
–peer-cert-file对等服务器TLS证书文件的路径。noneETCD_PEER_CERT_FILE
–peer-key-file对等服务器TLS密钥文件的路径noneETCD_PEER_KEY_FILE
–peer-client-cert-auth启用对等客户端证书认证。falseETCD_PEER_CLIENT_CERT_AUTH
–peer-trusted-ca-file对等服务器的路径TLS可信CA文件。noneETCD_PEER_TRUSTED_CA_FILE

Logging Flags

flag说明默认值环境变量
–debug将所有子包的默认日志级别降为DEBUG。false (INFO for all packages)ETCD_DEBUG
–log-package-levels将各个etcd子包设置为特定的日志级别。例如etcdserver=WARNING,security=DEBUGnone (INFO for all packages)ETCD_LOG_PACKAGE_LEVELS
–name这个成员的可读名称noneETCD_NAME

Unsafe Flags

使用不安全标志时请小心,因为它会破坏共识协议给出的保证。例如,如果集群中的其他成员仍然活着,它可能会出现panic。按照说明使用这些标志

flag说明默认值环境变量
–force-new-cluster强制创建一个新的一个成员群集。它提交配置更改强制删除群集中的所有现有成员并添加它自己。它需要设置为恢复备份falseETCD_FORCE_NEW_CLUSTER

Experimental Flags

flag说明默认值环境变量
–experimental-v3demo启用实验性v3演示APIfalseETCD_EXPERIMENTAL_V3DEMO

Miscellaneous Flags

flag说明默认值环境变量
–version打印版本并退出。false-

Profiling flags

flag说明默认值环境变量
–enable-pprof通过HTTP服务器启用运行时分析数据。地址在客户端URL+ “/debug/pprof/”false-

参考链接

ETCD官网

END

欢迎关注公众号 程序员工具集 👍👍 致力于分享优秀的开源项目、学习资源 、常用工具

回复关键词“关注礼包”,送你一份最全的程序员技能图谱。

回复关键词"wx"添加个人微信,勾搭作者,欢迎来聊^-^。