BGP 支持¶

Kube-OVN 支持将 Pods、Subnets、Services 和 EIPs 的 IP 地址通过 BGP 协议向外部进行路由广播，从而使得外部可以直接访问到集群内的 IP 地址。如果需要使用该功能，需要在特定节点安装 kube-ovn-speaker 并对需要对外暴露的 Pod 或 Subnet 增加对应的 annotation。

如果要在 EIP 上使用 BGP，需要使用特殊参数创建 VPC NAT Gateway，有关更多信息，请参阅发布 EIPs。

安装 kube-ovn-speaker¶

kube-ovn-speaker 内使用 GoBGP 对外发布路由信息，并将访问暴露地址的下一跳路由指向自身。

由于部署 kube-ovn-speaker 的节点需要承担回程流量，因此需要选择特定节点进行部署：

kubectl label nodes speaker-node-1 ovn.kubernetes.io/bgp=true
kubectl label nodes speaker-node-2 ovn.kubernetes.io/bgp=true

当存在多个 kube-ovn-speaker 实例时，每个实例都会对外发布路由，上游路由器需要支持多路径 ECMP。

下载对应 yaml:

wget https://raw.githubusercontent.com/kubeovn/kube-ovn/release-1.12/yamls/speaker.yaml

修改 yaml 内相应配置：

--neighbor-address=10.32.32.1
--neighbor-as=65030
--cluster-as=65000

neighbor-address: BGP Peer 的地址，通常为路由器网关地址。
neighbor-as: BGP Peer 的 AS 号。
cluster-as: 容器网络的 AS 号。

部署 yaml:

kubectl apply -f speaker.yaml

发布 Pod/Subnet 路由¶

如需使用 BGP 对外发布路由，首先需要将对应 Subnet 的 natOutgoing 设置为 false，使得 Pod IP 可以直接进入底层网络。

增加 annotation 对外发布：

kubectl annotate pod sample ovn.kubernetes.io/bgp=true
kubectl annotate subnet ovn-default ovn.kubernetes.io/bgp=true

删除 annotation 取消发布：

kubectl annotate pod sample ovn.kubernetes.io/bgp-
kubectl annotate subnet ovn-default ovn.kubernetes.io/bgp-

查看发布策略以了解如何通过设置注解来控制 BGP 对外发布策略。

发布 `ClusterIP` 类型 Service 路由¶

要将 Service 的 ClusterIP 公布给外部，需要将 kube-ovn-speaker 选项 --announce-cluster-ip 设置为 true。有关更多详细信息，请参阅 BGP 高级选项。

增加 annotation 对外发布：

kubectl annotate service sample ovn.kubernetes.io/bgp=true

删除 annotation 取消发布：

kubectl annotate service sample ovn.kubernetes.io/bgp-

发布 EIPs¶

EIPs 可以由它们所在的 VPC NAT Gateway 对外发布。当在 VpcNatGateway 上启用 BGP 时，会向其注入一个新的 BGP Sidecar。

为了启用 VPC NAT Gateway 的 BGP 功能，搜选需要创建一个 BGP Speaker Sidecar 所使用的 NetworkAttachmentDefinition。这个 NAD 将会和一个在默认 VPC 下的 Subnet 关联。这样 Sidecar 内的控制器可以和 Kubernetes API 通信并自动同步 EIPs 信息。如果你使用了用户自定义 VPC 下 CoreDNS 的功能则可以复用同一个 NAD。

创建 NetworkAttachmentDefinition 和 Subnet 并将 provider 设置为 {nadName}.{nadNamespace}.ovn：

apiVersion: "k8s.cni.cncf.io/v1"
kind: NetworkAttachmentDefinition
metadata:
  name: api-ovn-nad
  namespace: default
spec:
  config: '{
      "cniVersion": "0.3.0",
      "type": "kube-ovn",
      "server_socket": "/run/openvswitch/kube-ovn-daemon.sock",
      "provider": "api-ovn-nad.default.ovn"
    }'
---
apiVersion: kubeovn.io/v1
kind: Subnet
metadata:
  name: vpc-apiserver-subnet
spec:
  protocol: IPv4
  cidrBlock: 100.100.100.0/24
  provider: api-ovn-nad.default.ovn

在 ovn-vpc-nat-config ConfigMap 里需要添加 apiNadProvider 和 BGP Speaker 所使用的镜像:

apiVersion: v1
kind: ConfigMap
metadata:
  name: ovn-vpc-nat-config
  namespace: kube-system
data:
  apiNadProvider: api-ovn-nad.default.ovn              # What NetworkAttachmentDefinition provider to use so that the sidecar
                                                       # can access the K8S API, as it can't by default due to VPC segmentation
  bgpSpeakerImage: docker.io/kubeovn/kube-ovn:v1.13.0  # Sets the BGP speaker image used
  image: docker.io/kubeovn/vpc-nat-gateway:v1.13.0

修改 ovn-default 子网使用相同的 provider：

provider: api-ovn-nad.default.ovn

在 VPC NAT Gateway 的配置里开启 BGP：

kind: VpcNatGateway
apiVersion: kubeovn.io/v1
metadata:
  name: vpc-natgw
spec:
  vpc: vpc1
  subnet: net1
  lanIp: 10.0.1.10
  bgpSpeaker:
    enabled: true
    asn: 65500
    remoteAsn: 65000
    neighbors:
      - 100.127.4.161
      - fd:01::1
    enableGracefulRestart: true # Optional
    routerId: 1.1.1.1           # Optional
    holdTime: 1m                # Optional
    password: "password123"     # Optional
    extraArgs:                  # Optional, passed directly to the BGP speaker
      - -v5                     # Enables verbose debugging of the BGP speaker sidecar
  selector:
    - "kubernetes.io/os: linux"
  externalSubnets:
  - ovn-vpc-external-network # Network on which we'll speak BGP and receive/send traffic to the outside world
                             # BGP neighbors need to be on that network

现在可以通过注解，对外通过 BGP 发布这个 EIP：

kubectl annotate eip sample ovn.kubernetes.io/bgp=true

发布策略¶

kube-ovn-speaker 支持两种发布路由的策略:

Cluster: 在这个策略下要求每个 speaker 都会对外发布 Pod IPs/Subnet CIDRs，无论当前节点是否有具有特定 IP 或属于该节点上的子网 CIDR 的 Pod。换句话说，流量可能从任何 speaker 节点进入，然后在集群内部路由到实际的 Pod。在这种配置中可能会使用额外的跳数。这是 Pod 和 Subnet 的默认发布策略。
Local: 在这个策略下，Pod IPs 的路由只会从 Pod 所在的节点被发布。这意味着相比 Cluster 策略外部流量会直接到到 Pod 所在节点，跳数会更少。

注意: 为了使用 Local 发布策略，你需要在每个节点都运行 kube-ovn-speaker。如果 Pod 所在的节点没有 speaker 运行，路由将无法对外发布。

默认的发布策略为 Cluster，可以通过 Pod/Subnet 的 annotation ovn.kubernetes.io/bgp 来进行更改：

ovn.kubernetes.io/bgp=cluster 或 ovn.kubernetes.io/bgp=yes 将会使用 Cluster 策略。
ovn.kubernetes.io/bgp=local 将会使用 Local 策略。

注意：由于 Service 的流量最终是由 kube-proxy 进行处理，ClusterIP 类型 Service 对外发布路由只支持 Cluster 策略。

BGP 高级选项¶

kube-ovn-speaker 支持更多 BGP 参数进行高级配置，用户可根据自己网络环境进行调整：

announce-cluster-ip: 是否对外发布 Service 路由，默认为 false。
auth-password: BGP peer 的访问密码。
holdtime: BGP 邻居间的心跳探测时间，超过改时间没有消息的邻居将会被移除，默认为 90 秒。
graceful-restart: 是否启用 BGP Graceful Restart。
graceful-restart-time: BGP Graceful restart time 可参考 RFC4724 3。
graceful-restart-deferral-time: BGP Graceful restart deferral time 可参考 RFC4724 4.1。
passivemode: Speaker 运行在 passive 模式，不主动连接 peer。
ebgp-multihop: ebgp ttl 默认值为 1。

微信群 Slack Twitter Support Meeting