flannel 从 ETCD 中读取配置。
默认情况下,flannel 从 /coreos.com/network/config
中读取配置,可以使用 --etcd-prefix
覆盖。
通过 etcdctl
工具设置 ETCD 中的值。
配置值是一个带有以下键的 JSON 字典:
- Network (字符串):CIDR 格式的 IPv4 网络,用于整个 flannel 网络,这是唯一的必填字段。
- SubnetLen(整数):分配给每个主机的子网的大小。默认为 24(即
/24
),除非 Network 被配置为比/24
小,在这种情况下,它比 Network 小 1。 - SubnetMin(字符串):分配的子网对应的 IP 地址段的起始值。默认为 Network 的第一个子网。
- SubnetMax(字符串):分配的子网对应的 IP 地址段的结束值。默认为 Network 的最后一个子网。
- Backend (字典 dictionary):要使用的后端类型以及该后端的特定配置。默认为
udp
后端。
子网租赁的有效时间为 24 小时。除非使用 --subnet-lease-renew-margin-margin
选项设置了不同的更新值,租约将在其到期 1 小时内续订。
JSON 配置示例
以下配置说明了使用 udp
后端的大多数选项:
{
"Network": "10.0.0.0/8",
"SubnetLen": 20,
"SubnetMin": "10.10.0.0",
"SubnetMax": "10.99.0.0",
"Backend": {
"Type": "udp",
"Port": 7890
}
}
重要的命令行选项
--public-ip="" # 可被其他节点访问以进行主机间通信的 IP。默认为用于通信的接口的IP
--etcd-endpoints=http://127.0.0.1:4001 # 以逗号分隔的 etcd 端点列表
--etcd-prefix=/coreos.com/network # etcd 前缀
--etcd-keyfile="" # 用于 etcd 通信的 SSL 密钥文件
--etcd-certfile="" # 用于 etcd 通信的 SSL 证书文件
--etcd-cafile="" # 用于 etcd 通信的 SSL Certificate Authority 文件
--kube-subnet-mgr # 联系 Kubernetes API 进行子网分配而不是 etcd
--iface="" # 用于主机间通信的接口(IP 或域名)。默认为机器上默认路由的接口。这可以指定多次,以便按顺序检查每个选项。返回找到的第一个匹配项。=
--iface-regex="" # 正则表达式,匹配第一个要使用的主机间通信的接口(IP 或域名)。如果未指定,则默认为机器上默认路由的接口。这可以指定多次来按顺序检查每个正则表达式。返回找到的第一个匹配项。该选项被 iface 选项取代,只有在 iface 选项中没有指定任何选项时才会使用该选项
--iptables-resync=5 # 以秒为单位重新同步 iptables 规则。默认为 5 秒,如果发生大量的 iptables 锁争用,可以尝试增大这个值
--subnet-file=/run/flannel/subnet.env # 用于写入 env 变量(子网和 MTU 值)的文件名
--subnet-lease-renew-margin=60 # 子网租约续约提前量,单位分支
--ip-masq=false # 为发往 flannel 网络外部的流量设置 IP 伪装。Flannel 假定 NAT POSTROUTING 链中的默认策略是 ACCEPT
-v=0 # V 日志的日志级别。设置为 1 以查看与数据路径相关的消息
--healthz-ip="0.0.0.0" # healthz 服务器要侦听的 IP 地址(默认为“0.0.0.0”)
--healthz-port=0 # healthz 服务器侦听的端口(0 表示禁用)
--version # 打印版本并退出
MTU 由 flannel 自动计算和设置。然后它会在 subnet.env
中报告该值。这个值不能改变。
环境变量
上面列出的命令行选项也可以通过环境变量指定。例如 --etcd-endpoints=http://10.0.0.2:2379
等同于 FLANNELD_ETCD_ENDPOINTS=http://10.0.0.2:2379
环境变量。任何命令行选项都可以变成一个环境变量,方法是用 FLANNELD_
作为前缀,并去掉前导破折号,转换为大写字母并将所有其他破折号替换为下划线。
健康检查
Flannel 提供了一个负责健康检查的 http 端点 healthz
。目前,当 flannel 运行时,这个端点将一直返回 http 状态 ok(即 200)。该功能默认是禁用的。将 healthz-port
设置为非零值将启用 flannel 的 healthz 服务器。