keepalived02-keepalived的配置文件
1、keepalived配置文件的概述
- keepalived.conf是keepalived的配置文件。
- 关键字被放置在块和子块的层次结构中，每一层由“{”和“}”对分隔。
- 注释符：'#'或'!'。
- include：允许主配置文件加载其他配置文件。
#FILENAME可以是一个绝对或相对路径，并且可以包含通配符，以及csh风格的大括号表达式，如"{foo/{,cat,dog},bar}"，如果glob()支持它们的话。
include FILENAME
includer FILENAME #与include_check readable相同
includem FILENAME #与include_check match相同
includew FILENAME #与include_check wildcard_match相同
includeb FILENAME #与include_check brace_match相同
includea FILENAME #所有include_check检查
- 参数语法
- <BOOL>为on|off|true|false|yes|no之一
- <TIMER>是一个以秒为单位的时间值，例如2.71828或3；定时器的分辨率为微秒。
- Keepalived配置文件有四个顶级配置块：
- GLOBAL配置
- BFD配置
- VRRPD配置
- LVS配置
- keepalivd配置文件常见的结构
#全局配置块
global_defs {
......
}
#定义一个虚拟路由器
vrrp_instance <STRING> {
authentication { #一个虚拟路由器广播通信时的认证信息
......
}
virtual_ipaddress { #配置vip
......
}
}
#定义一个ipvs虚拟服务
virtual_server <IPADDR> [<PORT>] | #使用IP+Port定义集群服务
virtual_server fwmark <INTEGER> | #使用防火墙标记定义集群服务
virtual_server group <STRING> {
real_server <IPADDR> [<PORT>] { #定义一个后端服务器（RS）
HTTP_GET { #HTTP健康检查器
url {
......
}
}
TCP_CHECK { #TCP健康检查器
......
}
}
}
2、四个顶级配置块
2.1、GLOBAL配置块
- GLOBAL顶级配置块中包含的子块有：Global definitions、Linkbeat interfaces、Interface up/down transition delays、Static track groups、Static addresses、Static routes、Static rules。
global_defs {
#向哪些邮件发送警告
notification_email {
admin@example1.com
...
}
#发送邮件的发件人的地址(default: keepalived@<local host name>)
notification_email_from admin@example.com
#邮件服务器(default port number: 25)
smtp_server 127.0.0.1 [<PORT>]
#连接邮件服务器的超时时间(秒)
smtp_connect_timeout 30
#标识机器的字符串，不必是主机名。(default: local host name)
router_id <STRING>
#VRRP通告使用的组播的IPv4地址，默认的VRRP组播地址是224.0.0.18，通常不希望更改。（不同keepalived集群的组播的IP地址尽量不同）
vrrp_mcast_group4 224.0.0.18
vrrp_skip_check_adv_addr
vrrp_strict
vrrp_garp_interval 0
vrrp_gna_interval 0
#配置VRRP的默认版本号(default: 2, but IPv6 instances will use version 3)
vrrp_version <2 or 3>
#配置VIP的默认网络接口。(default: eth0)
default_interface eth0
#VRRP通告使用的组播组IPv6地址(default: ff02::12)
vrrp_mcast_group6 ff02::12
#不向邮件发送警告
no_email_faults
#转换到MASTER后的第二组免费arp延迟。以秒为单位，0表示没有第二组。 (default: 5)
vrrp_garp_master_delay 10
#转换到MASTER后一次发送的免费ARP消息数。(default: 5)
vrrp_garp_master_repeat 1
#MASTER收到较低优先级的通告后，第二组免费arp的延迟。 (default: vrrp_garp_master_delay)
vrrp_garp_lower_prio_delay 10
#MASTER收到低优先级的通告后，一次发送的免费ARP消息的个数。(default: vrrp_garp_master_repeat)
vrrp_garp_lower_prio_repeat 1
#MASTER免费arp刷新的最小时间间隔。以秒为单位。(default: 0 (no refreshing))
vrrp_garp_master_refresh 60
#MASTER一次发送的免费ARP消息数
vrrp_garp_master_refresh_repeat 2
#接口发送免费ARP报文的延迟时间，单位是秒(resolution usecs)。(default: 0)
vrrp_garp_interval 0.001
}
2.2、BFD配置块
- 这是RFC5880(双向转发检测)的一个实现，它可以在两个keepalive实例之间工作，但在主/备VRRP实例之间使用非加权track_bfds意味着只有两个VRRP实例都运行时，该VRRP实例才能够运行，这在一定程度上违背了VRRP的目的。
- 这个实现已经用OpenBFDD进行了测试(可从https://github.com/dyninc/OpenBFDD获得)。
bfd_instance <STRING> {
#BFD邻居IP(同义词neighbour_ip)
neighbor_ip <IP ADDRESS>
#要使用的源IP(可选，除非为了确保本地端口有效，这是必需的)
source_ip <IP ADDRESS>
#所需的最小RX时间间隔，单位为ms(例如3.312)(default is 10 ms)
min_rx <DECIMAL>
#期望的最小TX间隔，单位为ms(分辨率为微秒)(default is 10 ms)
min_tx <DECIMAL>
#期望的空闲TX间隔，单位为ms(分辨率为微秒)(default is 1000 ms)
idle_tx <DECIMAL>
#在会话宣告down后，错过的报文数(default is 5)
multiplier <INTEGER>
#在被动模式下操作(默认为主动)
passive
# out going IPv4 ttl to use (default 255)
ttl <INTEGER>
# outgoing IPv6 hoplimit to use (default 64)
hoplimit <INTEGER>
#接收报文中ttl/hoplimit的最大减少值(默认为0)255禁用跳数检查255禁用跳数检查)
max_hops <INTEGER>
#默认跟踪权重。正常情况下，当bfd实例状态为up时，vrrp实例优先级增加正权值。当bfd实例状态为down时，负权值降低优先级。但是，如果指定了reverse，则优先级在up时降低，在down时增加。
weight <-253:253> [reverse]
#正常情况下，bfd事件通知同时发送给VRRP进程和checker进程。指定vrrp或checker将导致bfd_instance的事件通知只发送给指定的进程
vrrp
checker
}
2.3、VRRPD配置块
- VRRPD顶级配置块中包含的子块有：VRRP script(s)、VRRP synchronization group(s)、VRRP gratuitous ARP、unsolicited neighbour advert delay group(s)、VRRP instance(s)。
2.3.1、VRRP script(s)配置子块
- 脚本将周期性地执行，间隔<interval>秒执行一次。
- 执行脚本连续失败<fall>次后，VRRP实例将会切换到fault状态。在此之后，如果执行脚本连续成功<rise>次，VRRP实例将会离开fault状态，除非VRRP实例由于跟踪其他脚本或接口而处于fault状态。
- 如果权重为正，则每1次成功，监视它的所有VRRP实例的优先级将增加<weight>。相反，在失败的情况下，将从初始优先级中减去一个负权重。
vrrp_script <SCRIPT_NAME> {
#脚本的路径
script <STRING>|<QUOTED-STRING>
#周期性地执行脚本，间隔<interval>秒执行一次。(default: 1 second)
interval <INTEGER>
#在该脚本被认为失败的几秒之后
timeout <INTEGER>
#调整优先级的权重(默认:0)。。
weight <INTEGER:-253..253> [reverse]
#执行脚本连续成功n次，状态从fail转换到ok
rise <INTEGER>
#执行脚本连续失败n次，状态从ok转换到fail
fall <INTEGER>
#运行脚本的用户/组名。group默认为用户组
user USERNAME [GROUPNAME]
#假设脚本最初处于失败状态
init_fail
}
2.3.2、VRRP instance(s)配置子块
vrrp_instance <STRING> {
#当前节点在这个虚拟路由器中的初始状态。在一个虚拟路由器中只能有一个是MASTER节点，其它节点都应该是BACKUP
state MASTER|BACKUP
#使用哪个网卡接口发送VRRP通告
interface eth0
#虚拟路由器的惟一标识，取值范围是1-255。(同一个虚拟路由器必须一样)
virtual_router_id 51
#当前主机在该虚拟路径器中的优先级，取值范围是1-255。
priority 100
#vrrp通告的时间间隔，单位秒
advert_int 1
#调用定义的vrrp_script
track_script {
<SCRIPT_NAME>
<SCRIPT_NAME> weight <-253..253> [reverse|no_reverse]
}
#vrrp通告时使用的认证信息
authentication {
#认证模式，建议使用简单认证pass
auth_type PASS|AH
#pass认证密码，只使用前8个字符
auth_pass 1234
}
#使用IPv4配置vip
virtual_ipaddress {
#不使用dev指定网卡接口时，就将vip绑定到interface指定的网卡接口
<IPADDR>[/<MASK>] [brd <IPADDR>] [dev <STRING>] [scope <SCOPE>] [label <LABEL>]
#辅助ip，查看要用ip命令
192.168.200.17/24 dev eth1
#别名ip，查看可用ifconfig命令
192.168.200.18/24 dev eth2 label eth2:1
}
#使用IPv6配置vip
virtual_ipaddress_excluded {
<IPADDR>[/<MASK>] [brd <IPADDR>] [dev <STRING>] [scope <SCOPE>] [label <LABEL>]
<IPADDR>[/<MASK>] ...
...
}
#当前节点转变为主节点时，要执行的脚本
notify_master <STRING>|<QUOTED-STRING> [username [groupname]]
#当前节点转变为备节点时，要执行的脚本
notify_backup <STRING>|<QUOTED-STRING> [username [groupname]]
#当前节点转变为fault状态时，要执行的脚本
notify_fault <STRING>|<QUOTED-STRING> [username [groupname]]
#停止VRRP时，要执行的脚本
notify_stop <STRING>|<QUOTED-STRING> [username [groupname]]
notify <STRING>|<QUOTED-STRING> [username [groupname]]
#如果master接收到优先级低于master的通告时，要执行的脚本
notify_master_rx_lower_pri <STRING>|<QUOTED-STRING> [username [groupname]]
#监控网络接口。重量必须在-253和+253之间，0是默认行为，这意味着如果被监控的网络接口出现故障，就转为fault状态
track_interface {
eth0
eth1
eth2 weight <-253..253> [reverse]
...
}
#VRRP版本号，默认是全局参数的vrrp_version。如果是IPv6就应该使用"version 3"
version <2 or 3>
#使用非抢占模式，默认是抢占模式。注意:为了使其工作，初始状态不能是MASTER。
nopreempt
#在抢占式模式下，指定延迟抢占的时间（当master节点通告的优先级低于本节点），以秒为单位。取值范围是0-1000，默认值是0。注意:为了使其工作，初始状态不能是MASTER。
preempt_delay 300 # waits 5 minutes
}
- 通用格式的通知触发机制，一个脚本可完成以上三种状态的转换时的通知
- notify <STRING>|<QUOTED-STRING>
2.4、LVS配置块
- LVS顶级配置块中包含的子块有：Virtual server group(s)和Virtual server(s)
- LVS配置块是通过定义虚拟服务器组、虚拟服务器和可选的SSL配置实现的。
- 每个虚拟服务器都定义了一组后端服务器，可以对将每个后端服务器进行healthcheckers。
2.4.1、Virtual server group(s)配置子块
virtual_server_group <STRING> {
# Virtual IP Address and Port
<IPADDR> [<PORT>]
<IPADDR> [<PORT>]
...
# <IPADDR RANGE> is any of the following forms (or their IPv6 equivalents)
# XXX.YYY.ZZZ.WWW-VVV eg 192.168.200.1-10 (includes both .1 and .10)
# AAA.BBB.CCC.DDD-EEE.FFF.GGG.HHH eg 192.168.200.250-192.168.201.10
# III.JJJ.KKK.LLL/nn eg 192.168.202.8/29
<IPADDR RANGE> [<PORT>] # VIP range [VPORT]
<IPADDR RANGE> [<PORT>]
...
# Firewall Mark (fwmark)
fwmark <INTEGER>
fwmark <INTEGER> [inet|inet6]
...
}
2.4.2、Virtual server(s)配置子块
virtual_server <IPADDR> [<PORT>] | #使用IP+Port定义集群服务
virtual_server fwmark <INTEGER> | #使用防火墙标记定义集群服务
virtual_server group <STRING> {
#定义调度方法
lvs_sched rr|wrr|lc|wlc|lblc|sh|mh|dh|fo|ovf|lblcr|sed|nq|twos
#指定LVS的模式，默认为NAT
lvs_method NAT|DR
lvs_method TUN [type {ipip|gue port NUM|gre} [nocsum|csum|remcsum]]
#LVS持久化引擎名称(目前只支持sip)
persistence_engine <STRING>
#LVS持久连接的时长(以秒为单位)，默认6分钟
persistence_timeout [<INTEGER>]
#LVS粒度掩码(ipvsadm中的-M)
persistence_granularity <NETMASK>
#服务协议
protocol TCP|UDP|SCTP
#备用后端服务器地址（sorry页面）
sorry_server <IPADDR> [<PORT>]
#服务轮询的时间间隔(默认为60秒)
delay_loop <TIMER>
#当健康检查程序检测到失败时，将权重设置为0
inhibit_on_failure
#定义一个后端服务器
real_server <IPADDR> [<PORT>] {
#后端服务器的权重，默认为1
weight <INTEGER>
#当后端服务器上线(up)时，要执行的脚本
notify_up <STRING>|<QUOTED-STRING> [username [groupname]]
#当后端服务器下线(down)时，要执行的脚本
notify_down <STRING>|<QUOTED-STRING> [username [groupname]]
#到后端服务器的最大连接数
uthreshold <INTEGER>
#到后端服务器的最小连接数
lthreshold <INTEGER>
#在状态转换期间发送电子邮件通知，是否使用上面global_defs中的地址
smtp_alert <BOOL>
#健康检查器有：HTTP_GET|SSL_GET|TCP_CHECK|SMTP_CHECK|DNS_CHECK|MISC_CHECK|BFD_CHECK|UDP_CHECK|PING_CHECK|FILE_CHECK
#HTTP健康检查器
HTTP_GET {
# HTTP协议版本：1.0、1.0C和1.1之一
http_protocol <PROTOCOL>
#测试的url，可以有多个条目
url {
#定义要监控的URL
path <STRING>
#根据响应内容的校验码判断后端服务器是否健康
#curl -s http://172.16.0.6 | md5sum 生成校验码命令
#genhash -s 172.16.0.6 -p 80 -u /index.html 生成校验码命令
digest <STRING>
#根据响应码判断后端服务器是否健康，默认值是200-299。建议使用
status_code <INTEGER|RANGE> [<INTEGER|RANGE>] ...
}
#向后端服务器的哪个IP地址发起健康状态检测请求，默认值是realserver IP
connect_ip <IPADDR>
#向后端服务器的哪个PORT发起健康状态检测请求，默认值是ealserver port
connect_port <PORT>
#发出健康状态检测请求的源IP地址
bindto <IPADDR>
#发出健康状态检测请求的源端口
bind_port <PORT>
#如果对活动后端服务器的检查失败，则需要检测n次。默认值为1
retry <INTEGER>
#失败后每次重试的时间间隔。DNS_CHECK默认为delay_loop，HTTP_GET和SSL_GET默认为3秒，其他默认为1秒
delay_before_retry <TIMER>
#连接的超时时长。默认为5秒
connect_timeout <TIMER>
}
#TCP健康检查器
TCP_CHECK {
#向后端服务器的哪个IP地址发起健康状态检测请求，默认值是realserver IP
connect_ip <IPADDR>
#向后端服务器的哪个PORT发起健康状态检测请求，默认值是ealserver port
connect_port <PORT>
#发出健康状态检测请求的源IP地址
bindto <IPADDR>
#发出健康状态检测请求的源端口
bind_port <PORT>
#如果对活动后端服务器的检查失败，则需要检测n次。默认值为1
retry <INTEGER>
#失败后每次重试的时间间隔。DNS_CHECK默认为delay_loop，HTTP_GET和SSL_GET默认为3秒，其他默认为1秒
delay_before_retry <TIMER>
#连接的超时时长。默认为5秒
connect_timeout <TIMER>
}
}
}
1
# #
