calico/routereflector

Calico Docker BIRD路由反射器镜像

概述

本镜像包含构建脚本，用于创建Calico BIRD路由反射器，可在Calico Docker节点集群中部署路由反射器集群。默认生成calico/routereflector镜像，也可直接使用DockerHub上的公开镜像，无需本地构建。

核心功能

1. 路由反射器集群全网格：路由反射器实例自动发现etcd中的其他实例，形成全网格对等关系。
2. 与Calico节点对等：通过Calico节点使用calicoctl配置与路由反射器的对等关系，无需额外修改路由反射器配置。
3. 多协议支持：兼容IPv4和IPv6地址。
4. 安全etcd连接：支持TLS/SSL加密的etcd集群连接。

使用场景

适用于大规模Calico Docker集群，需减少节点间全网格BGP连接数的场景，如：

• 节点数量超过100的集群，避免节点间直接建立大量BGP连接。
• 需要冗余路由反射器以提高可靠性的场景。

配置说明

启动路由反射器

在路由反射器主机上执行以下命令（需Docker v1.6+）：

bash
docker run -privileged -net=host -d \
           -e IP=<IPv4_RR> \
           [-e IP6=<IPv6_RR>] \
           -e ETCD_ENDPOINTS=<http://ETCD_IP:PORT> \
           calico/routereflector

参数说明：

• <IPv4_RR>：路由反射器主机的IPv4地址（BIRD实例绑定此地址）。
• <IPv6_RR>（可选）：路由反射器主机的IPv6地址（BIRD6实例绑定此地址）。
• <ETCD_IP:PORT>：etcd集群节点的IPv4地址和端口。

添加路由反射器到etcd

向etcd添加路由反射器条目，使其参与对等关系：

IPv4条目

bash
curl -L http://<ETCD_IP:PORT>:2379/v2/keys/calico/bgp/v1/rr_v4/<IPv4_RR> -XPUT -d value="{\"ip\":\"<IPv4_RR>\",\"cluster_id\":\"<CLUSTER_ID>\"}"

IPv6条目

bash
curl -L http://<ETCD_IP:PORT>:2379/v2/keys/calico/bgp/v1/rr_v6/<IPv6_RR> -XPUT -d value="{\"ip\":\"<IPv6_RR>\",\"cluster_id\":\"<CLUSTER_ID>\"}"

cluster_id为路由反射器集群的唯一标识（IPv4格式，如1.0.0.1）。

TLS/SSL加密的etcd连接

若etcd启用TLS/SSL，需挂载证书文件并设置环境变量：

bash
docker run -privileged -net=host -d \
           -e IP=<IPv4_RR> \
           [-e IP6=<IPv6_RR>] \
           -e ETCD_ENDPOINTS=<https://ETCD_IP:PORT> \
           -v <本地证书目录>:<容器挂载目录> \
           -e ETCD_CA_CERT_FILE=<容器挂载目录>/<CA证书文件> \
           -e ETCD_CERT_FILE=<容器挂载目录>/<客户端证书文件> \
           -e ETCD_KEY_FILE=<容器挂载目录>/<客户端密钥文件> \
           calico/routereflector

添加etcd条目时需携带证书：

bash
# IPv4条目
curl --cacert <本地CA证书> --cert <本地客户端证书> --key <本地客户端密钥> -L https://<ETCD_IP:PORT>:2379/v2/keys/calico/bgp/v1/rr_v4/<IPv4_RR> -XPUT -d value="{\"ip\":\"<IPv4_RR>\",\"cluster_id\":\"<CLUSTER_ID>\"}"

全局Calico配置

关闭节点全网格

bash
calicoctl bgp node-mesh off

设置默认节点AS号

查看当前AS号：

bash
calicoctl bgp default-node-as

修改AS号（如设置为65123）：

bash
calicoctl bgp default-node-as 65123

全局对等配置（可选）

若所有节点需与所有路由反射器对等：

bash
calicoctl bgp peer add <路由反射器IP> as <AS号>

节点特定对等配置

若节点仅需与部分路由反射器对等，在目标节点执行：

bash
calicoctl node bgp peer add <路由反射器IP> as <AS号>

多路由反射器拓扑

大规模集群中，可按机架划分路由反射器集群：

1. 每个机架分配唯一cluster_id（如1.0.0.1）。
2. 机架内节点与该机架的路由反射器对等。
3. 所有路由反射器自动形成全网格。 例如：

• 机架1的路由反射器RR1、RR2使用cluster_id=1.0.0.1，节点N1-N3与RR1、RR2对等。
• 机架2的路由反射器RR3、RR4使用cluster_id=1.0.0.2，节点N4-N6与RR3、RR4对等。
• 所有路由反射器自动建立全网格连接。