本文档介绍了如何为 Anthos clusters on Bare Metal 设置和使用具有边界网关协议 (BGP) 的捆绑式负载均衡器。此负载均衡模式支持通过外部边界网关协议 (eBGP) 为集群通告 ServiceType
LoadBalancer
虚拟 IP 地址 (VIP)。在此场景中,您的集群网络是一个自治系统,该系统通过对等互连与另一个自治系统(一个外部网络)互连。
具有 BGP 功能的捆绑式负载均衡器适用于所有集群类型,但管理员集群仅支持此功能的控制平面负载均衡部分。
使用具有 BGP 功能的捆绑式负载均衡器可提供以下优势:
- 使用 N 路主动/主动负载均衡功能,可实现更快的故障切换速度,并且可更高效地利用可用带宽。
- 支持第 3 层协议,该协议可与兼容 eBGP 的第三方架顶式 (ToR) 交换机和路由器进行互操作。
- 启用运行高级软件定义网络 (SDN) 栈的数据中心,可将第 3 层边界一直推送到集群。
使用 BGP 进行捆绑式负载均衡的工作原理
以下部分简要介绍了具有 BGP 的捆绑式负载均衡器的工作原理。
BGP 对等互连
具有 BGP 功能的捆绑式负载均衡器会启动与您的基础架构的多个 BGP 连接。BGP 具有以下技术要求:
- 控制平面 VIP 和服务 VIP 的对等互连会话是独立的。
- 控制平面对等互连会话从控制平面节点的 IP 地址发起。
- 服务对等互连会话从您在
AnthosNetworkGateway
自定义资源中指定的浮动 IP 地址发起。 - Anthos Network Gateway 控制器用于管理浮动 IP 地址。
- 基于 BGP 的捆绑式负载均衡仅支持 eBGP 对等互连。
- 默认支持多跃点对等互连。
- 不支持 BGP 会话上的 MD5 密码。
- 不支持基于 IPv6 的对等互连会话。
- 向任何对等体通告的路由应在整个网络中重新分布,并且可从集群中的其他任何位置进行访问。
- 强烈建议在接收模式下将 BGP
ADD-PATH
功能用于对等互连会话。 - 从每个对等体通告多个路径会产生主动/主动负载均衡。
- 应为您的网络启用等价多路径路由 (ECMP),以便多个路径可用于在一组负载均衡器节点之间分布流量。
控制平面负载均衡
集群中的每个控制平面节点都会与基础架构中的一个或多个对等体建立 BGP 会话。我们要求每个控制平面节点至少有一个对等节体。在集群配置文件中,您可以配置哪些控制平面节点连接到哪些外部对等体。
下图展示了控制平面对等互连的示例。集群在一个子网中有两个控制平面节点,在另一个子网中有一个控制平面节点。每个子网中都有一个外部对等体 (TOR),并且 Anthos clusters on Bare Metal 控制平面节点与其 TOR 对等互连。
服务负载均衡
除了从控制平面对等互连的每个控制平面节点发起的对等互连会话以外,系统还会为 LoadBalancer
服务发起其他对等互连会话。这些对等互连会话不是直接从集群节点 IP 发起,而是使用浮动 IP。
使用 externalTrafficPolicy=Local
网络政策的服务不受支持。
浮动 IP 地址
服务负载均衡要求您在集群节点子网中预留浮动 IP 地址,以用于 BGP 对等互连。集群至少需要一个浮动 IP 地址,但我们建议您至少预留两个地址,以确保 BGP 会话的高可用性。浮动 IP 地址在 AnthosNetworkGateway
自定义资源 (CR) 中指定,可以包含在集群配置文件中。
浮动 IP 地址消除了将 BGP 发言者 IP 地址映射到节点的麻烦。Anthos Network Gateway 控制器负责将 AnthosNetworkGateway
分配给节点,还会管理浮动 IP 地址。如果节点发生故障,则 Anthos Network Gateway 控制器会重新分配浮动 IP 地址,以确保外部对等体具有要与之建立对等互连的确定性 IP 地址。
外部对等体
您可以在添加到集群配置文件的 BGPLoadBalancer
自定义资源中指定具有浮动 IP 地址的对等互连会话所使用的外部对等体。外部对等体可以与集群配置文件的 loadBalancer.controlPlaneBGP
部分中为控制平面对等互连指定的相同,也可以指定不同的对等体。
Anthos Network Gateway 控制器会尝试从一组预留的浮动 IP 地址与每个外部对等体建立两个会话。我们建议您至少指定两个外部对等体,以确保 BGP 会话的高可用性。为服务负载均衡指定的每个外部对等体都必须配置为与 AnthosNetworkGateway
自定义资源中指定的每个浮动 IP 地址对等互连。
负载均衡器节点
集群中的部分节点用于负载均衡,这意味着它们是能够接受传入的负载均衡流量的通告节点。这组节点默认为控制平面节点池,但您可以在集群配置文件的 loadBalancer
部分中指定其他节点池。如果指定节点池,则它可用于负载均衡器节点,而不是控制平面节点池。
浮动 IP 地址(充当 BGP 发言者)不一定在负载均衡器节点上运行。浮动 IP 地址会分配给同一子网中的节点,并且对等互连会从此节点发起,无论此节点是否为负载均衡器节点都是如此。但是,通过 BGP 通告的下一个跃点始终是负载均衡器节点。
示例对等互连拓扑
下图展示了具有 BGP 对等互连的服务负载均衡示例。有两个浮动 IP 地址分配给其各自子网中的节点。定义了两个外部对等体。每个浮动 IP 都与两个外部对等体对等互连。
设置 BGP 负载均衡器
以下部分介绍如何将集群和外部网络配置为使用具有 BGP 的捆绑式负载均衡器。
规划与外部基础架构的集成
为了使用具有 BGP 的捆绑式负载均衡器,您需要设置外部基础架构:
必须将外部基础架构配置为与集群中的每个控制平面节点对等互连,以设置控制平面通信。这些对等互连会话用于通告 Kubernetes 控制平面 VIP。
外部基础架构必须配置为与一组预留的浮动 IP 地址对等互连,以进行数据平面通信。浮动 IP 地址用于服务 VIP 的 BGP 对等互连。我们建议您使用两个浮动 IP 地址和两个对等体,以确保 BGP 会话的高可用性。在将集群配置为使用 BGP 进行捆绑式负载均衡部分中描述了预留浮动 IP 的过程。
配置基础架构后,将 BGP 对等互连信息添加到集群配置文件中。您创建的集群可以发起与外部基础架构的对等互连会话。
将集群配置为使用 BGP 进行捆绑式负载均衡
创建集群时,您需要在集群配置文件中启用和配置使用 BGP 进行捆绑式负载均衡。
将
baremetal.cluster.gke.io/enable-anthos-network-gateway
注解添加到集群配置文件中并将其设置为true
。此注解会启用 Anthos Network Gateway 控制器。
apiVersion: baremetal.cluster.gke.io/v1 kind: Cluster metadata: name: bm namespace: cluster-bm # This annotation is required for BGP load balancer annotations: baremetal.cluster.gke.io/enable-anthos-network-gateway: "true" spec: ...
在集群配置文件的
loadBalancer
部分中,将mode
设置为bundled
,并添加值为bgp
的type
字段。这些字段值会启用基于 BGP 的捆绑式负载均衡。
... loadBalancer: mode: bundled # type can be 'bgp' or 'layer2'. If no type is specified, we default to layer2. type: bgp ...
如需指定控制平面的 BGP 对等互连信息,请将以下字段添加到
loadBalancer
部分中:... # AS number for the cluster localASN: CLUSTER_ASN # List of BGP peers used for the control plane peering sessions. bgpPeers: - ip: PEER_IP asn: PEER_ASN # optional; if not specified, all CP nodes connect to all peers. controlPlaneNodes: # optional - CP_NODE_IP ...
请替换以下内容:
CLUSTER_ASN
:要创建的集群的自治系统编号。PEER_IP
:外部对等设备的 IP 地址。PEER_ASN
:外部对等设备所属网络的自治系统编号。CP_NODE_IP
:(可选)连接到外部对等体的控制平面节点的 IP 地址。如果未指定任何控制平面节点,则所有控制平面节点都可以连接到外部对等体。如果指定一个或多个 IP 地址,则只有指定的节点会参与对等互连会话。
您可以指定多个外部对等体,
bgpPeers
采用映射列表。我们建议您为 BGP 会话至少指定两个外部对等体,以实现高可用性。如需查看包含多个对等体的示例,请参阅示例配置。创建集群后,无法更新控制平面的此 BGP 对等互连配置。
设置
loadBalancer.ports
、loadBalancer.vips
和loadBalancer.addressPools
字段(显示默认值)。... loadBalancer: ... # Other existing load balancer options remain the same ports: controlPlaneLBPort: 443 # When type=bgp, the VIPs are advertised over BGP vips: controlPlaneVIP: 10.0.0.8 ingressVIP: 10.0.0.1 addressPools: - name: pool1 addresses: - 10.0.0.1-10.0.0.4 ...
指定要用于对数据平面进行负载均衡的集群节点。
这是可选步骤。如果您未对
nodePoolSpec
部分取消备注,则控制平面节点用于数据平面负载均衡。... # Node pool used for load balancing data plane (nodes where incoming traffic # arrives. If not specified, this defaults to the control plane node pool. # nodePoolSpec: # nodes: # - address: <Machine 1 IP> ...
通过配置
AnthosNetworkGateway
自定义资源来预留浮动 IP 地址:浮动 IP 地址会在对等互连会话中用于数据平面负载均衡。
... --- apiVersion: networking.gke.io/v1alpha1 kind: AnthosNetworkGateway metadata: name: default namespace: CLUSTER_NAMESPACE spec: floatingIPs: - FLOATING_IP ...
请替换以下内容:
CLUSTER_NAMESPACE
:集群的命名空间。默认情况下,Anthos clusters on Bare Metal 的集群命名空间是以cluster-
开头的集群名称。例如,如果您将集群命名为test
,则命名空间将为cluster-test
。FLOATING_IP
:集群的其中一个子网的 IP 地址。您必须指定至少一个 IP 地址,但我们建议您指定至少两个 IP 地址。
如需查看
AnthosNetworkGateway
自定义资源规范可能类似于的内容示例,请参阅示例配置。通过配置
BGPLoadBalancer
自定义资源来指定数据平面的 BGP 对等互连信息:... --- apiVersion: networking.gke.io/v1alpha1 kind: BGPLoadBalancer metadata: name: bgplb namespace: CLUSTER_NAMESPACE spec: localASN: CLUSTER_ASN peers: - peerIP: PEER_IP peerASN: PEER_ASN ...
请替换以下内容:
CLUSTER_NAMESPACE
:集群的命名空间。默认情况下,Anthos clusters on Bare Metal 的集群命名空间是以cluster-
开头的集群名称。例如,如果您将集群命名为test
,则命名空间将为cluster-test
。CLUSTER_ASN
:要创建的集群的自治系统编号。PEER_IP
:外部对等设备的 IP 地址。您必须指定至少一个外部对等体,但我们建议您指定至少两个对等体。您可以使用在控制平面中指定的对等体。PEER_ASN
:外部对等设备所属网络的自治系统编号。
您可以指定多个外部对等体,
peers
采用映射对列表。我们建议您为 BGP 会话至少指定两个外部对等体,以实现高可用性。如需查看包含多个对等体的示例,请参阅示例配置。运行
bmctl cluster create
创建集群时,将运行预检检查。除了其他检查之外,预检检查还会验证控制平面的 BGP 对等互连配置,并在创建集群之前直接向管理员工作站报告任何问题。
使用 BGP ADD-PATH
为每个会话通告多个下一个跃点
我们强烈建议您对 RFC 7911 中指定的对等会话使用 BGP ADD-PATH
功能。默认情况下,BGP 协议只允许为单个前缀向对等体通告单个下一跃点。BGP ADD-PATH
允许为同一前缀通告多个下一跃点。将 ADD-PATH
与基于 BGP 的捆绑式负载均衡结合使用时,集群可以将多个集群节点作为负载均衡器服务(前缀)的前端节点(下一个跃点)通告。在网络中启用 ECMP,以便流量可以分配到多条路径。通过将多个集群节点通告为下一跃点来扇出流量,提高了负载均衡的数据平面容量的扩缩能力。
如果您的外部对等设备(例如架顶式 (ToR) 交换机或路由器)支持 BGP ADD-PATH
,则仅启用接收扩展程序就已足够。使用 BGP 进行捆绑式负载均衡在没有 ADD-PATH
功能的情况下可正常运行,但针对每个对等互连会话通告单个负载均衡节点的限制会限制负载均衡器数据平面容量。如果没有 ADD-PATH
,Anthos clusters on Bare Metal 会选取从负载均衡器节点池通告的节点,并尝试将不同 VIP 的下一个跃点分布在不同节点上。
仅限负载均衡器节点使用 BGP 对等互连
在此功能的预览版本中,Anthos clusters on Bare Metal 会自动在与浮动 IP 地址位于同一子网的任何节点上分配浮动 IP 地址。即使这些 IP 地址未到达负载均衡器节点,BGP 会话也会从这些 IP 地址发起。此行为是设计使然,因为我们已将控制平面 (BGP) 与数据平面(负载均衡器节点池)分离。
如果要限制可用于 BGP 对等互连的一组节点,可以指定一个子网仅用于负载均衡器节点。也就是说,您可以将该子网中的所有节点都配置为位于负载均衡器节点池中。然后,在配置用于 BGP 对等互连的浮动 IP 地址时,请确保它们来自同一子网。Anthos clusters on Bare Metal 可确保浮动 IP 地址分配和 BGP 对等互连仅从负载均衡器节点发生。
配置示例
以下部分演示了如何为不同选项或行为配置基于 BGP 的负载均衡。
配置所有节点使用相同的对等体
如下图所示,此配置会生成一组外部对等体(10.8.0.10
和 10.8.0.11
),可供所有节点访问。控制平面节点(10.0.1.10
、10.0.1.11
和 10.0.2.10
)和分配给数据平面节点的浮动 IP 地址(10.0.1.100
和 10.0.2.100
)都可以访问这些对等体。
为 loadBalancer
Services 对等互连预留的浮动 IP 地址(10.0.1.100
或 10.0.2.100
)均可访问同一外部对等体。浮动 IP 地址可以分配给位于同一子网中的节点。
如以下集群配置示例所示,您可以在不指定 controlPlaneNodes
的情况下为控制平面节点 bgpPeers
配置对等体。如果没有为对等体指定节点,则所有控制平面节点会连接到所有对等体。
您可以在 AnthosNetworkGateway
自定义资源中指定用于 Service 负载均衡对等互连会话的浮动 IP 地址。您可以在 BGPLoadBalancer
资源中指定相应的外部对等体。
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: bm
namespace: cluster-bm
spec:
...
loadBalancer:
mode: bundled
# type can be 'bgp' or 'layer2'. If no type is specified, we default to layer2.
type: bgp
# AS number for the cluster
localASN: 65001
bgpPeers:
- ip: 10.8.0.10
asn: 65002
- ip: 10.8.0.11
asn: 65002
... (other cluster config omitted)
---
apiVersion: networking.gke.io/v1alpha1
kind: AnthosNetworkGateway
metadata:
name: default
namespace: cluster-bm
spec:
floatingIPs:
- 10.0.1.100
- 10.0.2.100
---
apiVersion: networking.gke.io/v1alpha1
kind: BGPLoadBalancer
metadata:
name: bgplb
namespace: cluster-bm
spec:
localASN: 65001
peers:
- peerIP: 10.8.0.10
peerASN: 65002
- peerIP: 10.8.0.11
peerASN: 65002
将特定控制平面节点配置为与特定外部对等体对等互连
如下图所示,此配置生成两个控制平面节点(10.0.1.10
和 10.0.1.11
),这两个节点与一个外部对等体 (10.0.1.254
) 对等互连。第三个控制平面节点 (10.0.2.10
) 与另一个外部对等体 (10.0.2.254
) 对等互连。如果您不希望所有节点连接到所有对等体,此配置非常有用。例如,您可能希望控制平面节点仅与其对应的架顶式 (ToR) 交换机对等互连。
为服务负载均衡对等互连会话预留的任一浮动 IP 地址(10.0.1.100
或 10.0.2.100
)均可访问相同的外部对等体。浮动 IP 地址可以分配给位于同一子网中的节点。
如以下集群配置示例所示,您可以通过在 bgpPeers
部分的对等体的 controlPlaneNodes
字段中指定 IP 地址,限制哪些控制平面节点可以连接到给定对等体。
您可以在 AnthosNetworkGateway
自定义资源中指定用于 Service 负载均衡对等互连会话的浮动 IP 地址。您可以在 BGPLoadBalancer
资源中指定相应的外部对等体。
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: bm
namespace: cluster-bm
spec:
...
loadBalancer:
mode: bundled
# type can be 'bgp' or 'layer2'. If no type is specified, we default to layer2.
type: bgp
# AS number for the cluster
localASN: 65001
bgpPeers:
- ip: 10.0.1.254
asn: 65002
controlPlaneNodes:
- 10.0.1.10
- 10.0.1.11
- ip: 10.0.2.254
asn: 65002
controlPlaneNodes:
- 10.0.2.10
... (other cluster config omitted)
---
apiVersion: networking.gke.io/v1alpha1
kind: AnthosNetworkGateway
name: default
namespace: cluster-bm
spec:
floatingIPs:
- 10.0.1.100
- 10.0.2.100
---
apiVersion: networking.gke.io/v1alpha1
kind: BGPLoadBalancer
metadata:
name: bgplb
namespace: cluster-bm
spec:
localASN: 65001
peers:
- peerIP: 10.0.1.254
peerASN: 65002
- peerIP: 10.0.2.254
peerASN: 65002
单独配置控制平面和数据平面
如下图所示,此配置生成两个控制平面节点(10.0.1.10
和 10.0.1.11
),这两个节点与一个外部对等体 (10.0.1.254
) 对等互连。第三个控制平面节点 (10.0.2.10
) 与另一个外部对等体 (10.0.2.254
) 对等互连。
为服务负载均衡对等互连会话预留的任一浮动 IP 地址(10.0.3.100
或 10.0.3.101
)均可访问第三个外部对等体 (10.0.3.254
)。浮动 IP 地址可以分配给位于同一子网中的节点。
如以下集群配置示例所示,您可以通过在 bgpPeers
部分的对等体的 controlPlaneNodes
字段中指定 IP 地址,限制哪些控制平面节点可以连接到给定对等体。
您可以在 AnthosNetworkGateway
自定义资源中指定用于 Service 负载均衡对等互连会话的浮动 IP 地址。您可以在 BGPLoadBalancer
资源中指定相应的外部对等体。
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: bm
namespace: cluster-bm
spec:
...
loadBalancer:
mode: bundled
# type can be 'bgp' or 'layer2'. If no type is specified, we default to layer2.
type: bgp
# AS number for the cluster
localASN: 65001
bgpPeers:
- ip: 10.0.1.254
asn: 65002
controlPlaneNodes:
- 10.0.1.10
- 10.0.1.11
- ip: 10.0.2.254
asn: 65002
controlPlaneNodes:
- 10.0.2.11
... (other cluster config omitted)
---
apiVersion: networking.gke.io/v1alpha1
kind: AnthosNetworkGateway
name: default
namespace: cluster-bm
spec:
floatingIPs:
- 10.0.3.100
- 10.0.3.101
---
apiVersion: networking.gke.io/v1alpha1
kind: BGPLoadBalancer
name: bgplb
namespace: cluster-bm
spec:
bgp:
localASN: 65001
peers:
- peerIP: 10.0.3.254
peerASN: 65002
修改基于 BGP 的负载均衡配置
在创建集群并配置为使用 BGP 进行捆绑式负载均衡后,某些配置设置可以更新,但某些配置设置在创建集群后无法更新。
控制平面
在预览版期间,不支持修改控制平面负载均衡配置。
服务
您可通过修改 AnthosNetworkGateway
CR 和 BGPLoadBalancer
CR,在创建集群后修改 BGP 对等互连配置。对这些 CR 中的对等互连信息所做的任何修改都会反映在目标集群中的负载均衡解决方案配置中。
仅在管理员集群的集群命名空间中的源资源中进行更新。对目标(用户)集群中的资源进行的任何修改都会被覆盖。
问题排查
以下各部分介绍了如何访问使用 BGP 进行捆绑式负载均衡的问题排查信息。
控制平面 BGP 会话
控制平面 BGP 对等互连配置将在集群创建期间通过预检检查进行验证。预检检查会尝试执行以下操作:
- 与每个对等体建立 BGP 连接。
- 通告控制平面 VIP。
- 验证是否可以使用 VIP 访问控制平面节点。
如果您的集群创建未通过预检检查,请查看预检检查日志是否有错误。带有时间戳的预检检查日志文件位于 baremetal/bmctl-workspace/CLUSTER_NAME/log
目录中。
在运行时,控制平面 BGP 发言者在每个控制平面节点上作为静态 pod 运行,并将事件信息写入日志。这些静态 pod 的名称中包含“bgpadvertiser”,因此使用以下 kubectl get pods
命令可查看 BGP 发言者 Pod 的状态:
kubectl -n kube-system get pods | grep bgpadvertiser
Pod 正常运行后,响应应如下所示:
bgpadvertiser-node-01 1/1 Running 1 167m
bgpadvertiser-node-02 1/1 Running 1 165m
bgpadvertiser-node-03 1/1 Running 1 163m
使用以下命令查看 bgpadvertiser-node-01
Pod 的日志:
kubectl -n kube-system logs bgpadvertiser-node-01
服务 BGP 会话
BGPSession
资源提供有关当前 BGP 会话的信息。如需获取会话信息,请先获取当前会话,然后检索其中一个会话的 BGPSession
资源。
使用以下 kubectl get
命令列出当前会话:
kubectl -n kube-system get bgpsessions
该命令会返回会话列表,如下例所示:
NAME AGE
10.0.1.254-node-01 170m
10.0.1.254-node-05 170m
10.0.3.254-node-01 170m
10.0.3.254-node-05 170m
使用以下 kubectl describe
命令获取 10.0.1.254-node-01
BGP 会话的 BGPSession
资源:
kubectl -n kube-system describe bgpsession 10.0.1.254-node-01
返回的 BGPSession
资源应如以下示例所示:
Name: 10.0.1.254-node-01
Namespace: kube-system
Labels: <none>
Annotations: <none>
API Version: networking.gke.io/v1alpha1
Kind: BGPSession
Metadata:
(omitted)
Spec:
Floating IP: 10.0.1.178
Local ASN: 65500
Local IP: 10.0.1.178
Node Name: node-01
Peer ASN: 65000
Peer IP: 10.0.1.254
Status:
Advertised Routes:
10.0.4.1/32
Last Report Time: 2021-06-14T22:09:36Z
State: Established
使用 kubectl get
命令获取 BGPAdvertisedRoute
资源:
kubectl -n kube-system get bgpadvertisedroutes
响应应如以下示例所示,显示当前通告的路由:
NAME AGE
bgplb-default-load-balancer-example 5d5h
bgplb-gke-system-istio-ingress 6d
使用 kubectl describe
查看有关每个路由通告的下一个跃点的详细信息。
手动 BGP 验证
本部分包含手动验证 BGP 配置的说明。该过程会建立一条长时间运行的 BGP 连接,以便您与网络团队进一步调试 BGP 配置。在创建集群之前,请使用此过程验证您的配置,或者在与 BGP 相关的预检检查失败时使用此过程。
预检检查会自动执行以下 BGP 验证任务:
- 建立与对等体的 BGP 连接。
- 通告控制平面 VIP。
- 验证从所有其他集群节点发送到 VIP 地址的流量是否到达当前负载均衡器节点。
这些任务在每个控制平面节点上针对每个 BGP 对等体运行。在创建集群时,成功完成这些检查至关重要。但是,预检检查不会创建长时间运行的连接,因此排查故障很困难。
以下部分介绍了如何设置 BGP 连接并通告从单个集群机器到一个对等体的路由。如需测试多台机器和多个对等体,请使用其他机器和对等体组合再次按照这些说明执行操作。
请记住,BGP 连接是从控制平面节点建立的,因此请务必从一个计划的控制平面节点测试此过程。
获取 BGP 测试程序二进制文件
请在管理员工作站上执行本部分中的步骤。这些步骤会获取 bgpadvertiser
程序,用于测试 BGP 连接并将其复制到您要测试的控制平面节点。
拉取 ansible-runner Docker 映像。
不使用注册表镜像
如果不使用注册表镜像,请运行以下命令来拉取 ansible-runner Docker 映像:
gcloud auth login gcloud auth configure-docker docker pull gcr.io/anthos-baremetal-release/ansible-runner:1.10.0-gke.13
使用注册表镜像
如果您使用注册表镜像,请运行以下命令来拉取 ansible-runner Docker 映像:
docker login REGISTRY_HOST docker pull REGISTRY_HOST/anthos-baremetal-release/ansible-runner:1.10.0-gke.13
将 REGISTRY_HOST 替换为您的注册表镜像服务器的名称。
提取
bgpadvertiser
二进制文件。不使用注册表镜像
如需提取
bgpadvertiser
二进制文件,请运行以下命令:docker cp $(docker create gcr.io/anthos-baremetal-release/ansible-runner:1.10.0-gke.13):/bgpadvertiser .
使用注册表镜像
如需提取
bgpadvertiser
二进制文件,请运行以下命令:docker cp $(docker create REGISTRY_HOST/anthos-baremetal-release/ansible-runner:1.10.0-gke.13):/bgpadvertiser .
如需将
bgpadvertiser
二进制文件复制到您要测试的控制平面节点,请运行以下命令:scp bgpadvertiser USERNAME>@CP_NODE_IP:/tmp/
替换以下内容:
USERNAME
:用于访问控制平面节点的用户名。CP_NODE_IP
:控制平面节点的 IP 地址。
设置 BGP 连接
在控制平面节点上执行本部分中的步骤。
在节点上创建一个配置文件 (
/tmp/bgpadvertiser.conf
),如下所示:localIP: NODE_IP localASN: CLUSTER_ASN peers: - peerIP: PEER_IP peerASN: PEER_ASN
替换以下内容:
NODE_IP
:您正在使用的控制平面节点的 IP 地址。CLUSTER_ASN
:集群使用的自治系统编号。PEER_IP
:您要测试的某个外部对等体的 IP 地址。PEER_ASN
:外部对等设备所属网络的自治系统编号。
运行
bgpadvertiser
守护程序,注意替换以下命令中的控制平面 VIP 地址:/tmp/bgpadvertiser --config /tmp/bgpadvertiser.conf --advertise-ip CONTROL_PLANE_VIP
将
CONTROL_PLANE_VIP
替换为您要用于控制平面 VIP 地址的 IP 地址。此命令会使 BGP 通告方向对等体通告此地址。查看程序输出结果。
此时,
bgpadvertiser
守护程序启动,尝试连接到对等体并通告 VIP 地址。BGP 连接建立后,该程序会定期输出包含BGP_FSM_ESTABLISHED
的消息(请参阅以下示例输出结果)。{"level":"info","ts":1646788815.5588224,"logger":"BGPSpeaker","msg":"GoBGP gRPC debug endpoint disabled","localIP":"21.0.101.64"} {"level":"info","ts":1646788815.5596201,"logger":"BGPSpeaker","msg":"Started.","localIP":"21.0.101.64"} I0309 01:20:15.559667 1320826 main.go:154] BGP advertiser started. I0309 01:20:15.561434 1320826 main.go:170] Health status HTTP server started at "127.0.0.1:8080". INFO[0000] Add a peer configuration for:21.0.101.80 Topic=Peer {"level":"info","ts":1646788815.5623345,"logger":"BGPSpeaker","msg":"Peer added.","localIP":"21.0.101.64","peer":"21.0.101.80/4273481989"} DEBU[0000] IdleHoldTimer expired Duration=0 Key=21.0.101.80 Topic=Peer I0309 01:20:15.563503 1320826 main.go:187] Peer applied: {4273481989 21.0.101.80} DEBU[0000] state changed Key=21.0.101.80 Topic=Peer new=BGP_FSM_ACTIVE old=BGP_FSM_IDLE reason=idle-hold-timer-expired DEBU[0000] create Destination Nlri=10.0.0.1/32 Topic=Table {"level":"info","ts":1646788815.5670514,"logger":"BGPSpeaker","msg":"Route added.","localIP":"21.0.101.64","route":{"ID":0,"Metric":0,"NextHop":"21.0.101.64","Prefix":"10.0.0.1/32","VRF":""}} I0309 01:20:15.568029 1320826 main.go:199] Route added: {0 0 21.0.101.64 10.0.0.1/32 } I0309 01:20:15.568073 1320826 main.go:201] BGP advertiser serving... DEBU[0005] try to connect Key=21.0.101.80 Topic=Peer DEBU[0005] state changed Key=21.0.101.80 Topic=Peer new=BGP_FSM_OPENSENT old=BGP_FSM_ACTIVE reason=new-connection DEBU[0005] state changed Key=21.0.101.80 Topic=Peer new=BGP_FSM_OPENCONFIRM old=BGP_FSM_OPENSENT reason=open-msg-received INFO[0005] Peer Up Key=21.0.101.80 State=BGP_FSM_OPENCONFIRM Topic=Peer DEBU[0005] state changed Key=21.0.101.80 Topic=Peer new=BGP_FSM_ESTABLISHED old=BGP_FSM_OPENCONFIRM reason=open-msg-negotiated DEBU[0005] sent update Key=21.0.101.80 State=BGP_FSM_ESTABLISHED Topic=Peer attributes="[{Origin: i} 4273481990 {Nexthop: 21.0.101.64}]" nlri="[10.0.0.1/32]" withdrawals="[]" DEBU[0006] received update Key=21.0.101.80 Topic=Peer attributes="[{Origin: i} 4273481989 4273481990 {Nexthop: 21.0.101.64}]" nlri="[10.0.0.1/32]" withdrawals="[]" DEBU[0006] create Destination Nlri=10.0.0.1/32 Topic=Table DEBU[0035] sent Key=21.0.101.80 State=BGP_FSM_ESTABLISHED Topic=Peer data="&{{[] 19 4} 0x166e528}" DEBU[0065] sent Key=21.0.101.80 State=BGP_FSM_ESTABLISHED Topic=Peer data="&{{[] 19 4} 0x166e528}"
如果您没有看到这些消息,请仔细检查配置文件中的 BGP 配置参数,并跟网络管理员确认一下。现在,您已经设置了 BGP 连接。您可以跟网络管理员确认他们是否看到自己的那一端已建立连接,以及是否看到通告给他们的路由。
流量测试
如需测试网络可以将流量转发到 VIP 地址,您必须将 VIP 地址添加到正在运行 bgpadvertiser
的控制平面节点。在其他终端中运行以下命令,以便让 bgpadvertiser
保持运行状态:
将 VIP 地址添加到您的控制平面节点:
ip addr add CONTROL_PLANE_VIP/32 dev INTF_NAME
替换以下内容:
CONTROL_PLANE_VIP
:bgpadvertiser
的 VIP 地址--advertise-ip
参数。INTF_NAME
:节点上的 Kubernetes 接口。也就是说,该接口是具有您在 Anthos clusters on Bare Metal 配置中为loadBalancer.bgpPeers.controlPlaneNodes
输入的 IP 地址的接口。
从其他节点对 VIP 地址运行 ping 命令:
ping CONTROL_PLANE_VIP
如果 ping 命令不成功,则网络设备上的 BGP 配置可能存在问题。请与您的网络管理员合作验证配置并解决问题。
清理
在手动验证 BGP 正常运行后,请务必按照以下步骤重置节点。如果您没有正确重置节点,则手动设置可能会干扰预检检查或后续集群创建。
如果您为流量测试添加了 VIP 地址,请从控制平面节点中移除该地址:
ip addr del CONTROL_PLANE_VIP/32 dev INTF_NAME
在控制平面节点上的
bgpadvertiser
终端中,按Ctrl
+C
以停止 bgpadvertiser。验证没有
bgpadvertiser
进程正在运行:ps -ef | grep bgpadvertiser
如果您看到有进程正在运行,请使用
kill
命令停止这些进程。