文章20 | 阅读 8365 | 点赞0
Agent有各种各样的配置选项,这些配置选项可以通过命令行参数的方式设定,也可用通过配置文件的方式设定——所有的配置选项都是可选的,当然也是有默认值的。
当加载配置选项时,consul是按照词典顺序从所有配置文件或目录中加载。比如,basic_config.json会先于extra_config.json处理。后面设定的配置选项会合并到前面的配置集合中,如果存在重复的配置选项则会覆盖。当然,在某些情况下,比如事件处理程序,后面处理程序会追加到现有的配置选项中,形成事件处理程序列表。
Consul支持重新加载配置(在收到SIGHUP信号时),但也不是所有的改变都可以重新加载,只有某些ReLoadable Configuration可以重新加载。也可用通过命令重新加载,后面会介绍。
如下都是可以在命令行指定的参数:
Ø -config-file
需要加载的配置文件,在文件中都是json格式的信息,该参数可以多次配置,后面文件中加载的参数会覆盖前面加载文件中的参数。
Ø -config-dir
需要加载的配置文件目录,consul将加载目录下所有后缀为“.json”的文件,加载顺序为字母顺序,文件中配置选项合并方式如config-file。该参数可以多次配置。目录中的子目录是不会加载的。
Ø -data-dir
此目录是为Agent存放state数据的。是所有Agent需要的,该目录应该存放在持久存储中(reboot不会丢失),对于server角色的Agent是很关键的——需要记录集群状态。并且该目录是支持文件锁。
Ø -log-level
日志级别。默认为info。有如下级别:"trace","debug", "info", "warn", and "err"。可以使用consul monitor来连接agent查看日志。日志级别可以在reload时进行改变。
Ø -syslog
将日志记录进syslog(仅支持Linux和OSX平台)
Ø -pid-file
记录pid的文件
Ø -server
设置Agent是server模式还是client模式。Consul agent有两种运行模式:Server和Client。这里的Server和Client只是Consul集群层面的区分,与搭建在Cluster之上 的应用服务无关。Consule Server模式agent节点用于采用raft算法维护Consul集群的状态,官方建议每个Consul Cluster至少有3个或以上的运行在Server mode的Agent,Client节点不限。
Ø -client
将绑定到client接口的地址,可以是HTTP、DNS、RPC服务器。默认为“127.0.0.1”——只允许回路连接。RPC地址会被其他的consul命令使用,比如consul members——查询agent列表
Ø -node
节点在集群的名字,在集群中必须是唯一的。默认为节点的Hostname
Ø -bootstrap
设置服务是否为“bootstrap”模式。如果数据中心只有1个server agent,那么需要设置该参数。从技术上来讲,处于bootstrap模式的服务器是可以选择自己作为Raft Leader的。在consul集群中,只有一个节点可以配置该参数,如果有多个参数配置该参数,那么难以保证一致性。
Ø -bootstrap-expect
数据中心期望的server agent数目,不能与bootstrap一起使用。此参数要么不配置,要么consul集群中所有的server均配置相同的值。如果配置了该参数,只想当consul集群中有效server agent的数目达到此数量时才会引导集群启动。
Ø -dc
数据中心的名字
Ø -bind
用于集群内部通信的IP地址,与集群中其他节点互连可通。默认为“0.0.0.0”——consul将使用第一个有效的私有IPv4地址。如果指定“[::]”,consul将使用第一个有效的公共IPv6地址。使用TCP和UDP通信。注意防火墙,避免无法通信。
……
除了命令行配置外,配置选项也可以存放在文件中。这种方式在某种情况下是非常方便的,比如,配置选项是由配置管理系统来管理。
配置文件都是json格式的,是易读和易编辑的——在文件中,每一个json对象都是格式化的。
配置文件不仅仅可以设置Agent,而且还能够提供Check和service定义。参见check配置和service配置。Check配置与service配置均是可通过reload更新的。
配置文件示例
{
"datacenter": "east-aws",
"data_dir": "/opt/consul",
"log_level": "INFO",
"node_name": "foobar",
"server": true,
"watches": [
{
"type": "checks",
"handler": "/usr/bin/health-check-handler.sh"
}
],
"telemetry": {
"statsite_address": "127.0.0.1:2180"
}
}
配置文件示例(TLS)
{
"datacenter": "east-aws",
"data_dir": "/opt/consul",
"log_level": "INFO",
"node_name": "foobar",
"server": true,
"addresses": {
"https": "0.0.0.0"
},
"ports": {
"https": 8080
},
"key_file": "/etc/pki/tls/private/my.key",
"cert_file": "/etc/pki/tls/certs/my.crt",
"ca_file": "/etc/pki/tls/certs/ca-bundle.crt"
}
Ø datacenter
同命令行参数-datacenter
Ø data_dir
同命令行参数-data_dir
Ø bootstrap
同命令行参数-bootstrap
同命令行参数-bootstrap_expect
Ø bind_addr
同命令行参数-bind
Ø enable_syslog
同命令行参数-syslog
Ø log_level
同命令行参数-log_level
Ø node_name
同命令行参数node
……
Reload配置 并不能reload所有配置选项,下面的选项可以重载:
Ø Log level
Ø Checks
Ø Services
Ø Watches
Ø HTTP Client Address
Ø Atlas Token
Ø Atlas Infrastructure
Ø Atlas Endpoint
原文地址:https://www.consul.io/docs/agent/options.html#configuration_files
版权说明 : 本文为转载文章, 版权归原作者所有 版权申明
原文链接 : https://younger.blog.csdn.net/article/details/52243738
内容来源于网络,如有侵权,请联系作者删除!