Kube-OVN 外部网关标签重置问题分析与解决方案

问题背景

在使用 Kube-OVN 网络插件时，用户发现当节点被标记为外部网关（通过设置 ovn.kubernetes.io/external-gw=true 标签）后，一旦重启 kube-ovn-controller 组件，该标签会被自动重置为 false。这导致所有外部出口 IP（OEIP）和浮动 IP（OFIP）功能失效，网络连通性中断。

问题分析

该问题出现在 Kube-OVN v1.12.28 版本中，当控制器组件重启时，它会重新初始化节点标签状态。这种行为表明控制器组件在启动时没有正确保留或识别之前配置的外部网关标签。

从技术实现角度看，Kube-OVN 控制器负责管理 OVN 相关的网络配置，包括节点作为外部网关的功能。当控制器重启时，它可能基于某些默认配置或初始化逻辑重置了这些关键标签。

临时解决方案

用户最初采用的临时解决方案是通过定时任务（cronjob）定期检查并重新应用标签：

#!/bin/bash
NODES=$(kubectl get nodes -l node-role.kubernetes.io/compute=true -o jsonpath='{.items[*].metadata.name}')

for NODE in $NODES; do
    kubectl label node "$NODE" ovn.kubernetes.io/external-gw=true --overwrite
done

kubectl delete pod -n kube-system -l app=kube-ovn-controller

for NODE in $NODES; do
    kubectl label node "$NODE" ovn.kubernetes.io/external-gw=true --overwrite
done

这种方法虽然可行，但属于被动修复，不是根本解决方案。

推荐解决方案

经过深入分析，正确的解决方案是通过 ConfigMap 配置来永久启用外部网关功能。创建以下 ConfigMap 可以解决标签被重置的问题：

apiVersion: v1
kind: ConfigMap
metadata:
  name: ovn-external-gw-config
  namespace: kube-system
data:
  type: "distributed"
  enable-external-gw: "true"

这个配置明确告诉 Kube-OVN 系统：

1. 使用分布式外部网关模式（"distributed"）
2. 全局启用外部网关功能（enable-external-gw: "true"）

实现原理

当配置了上述 ConfigMap 后，Kube-OVN 控制器会在启动时读取这些配置，并据此初始化节点状态。这种方式比单纯依赖节点标签更可靠，因为：

1. ConfigMap 作为 Kubernetes 原生资源，其内容会被持久化存储
2. 控制器会优先使用这些配置而非默认值
3. 配置变更可以通过标准的 Kubernetes 配置管理流程进行管理

最佳实践

对于生产环境，建议：

1. 始终通过 ConfigMap 配置外部网关相关参数
2. 将 ConfigMap 纳入版本控制系统管理
3. 在升级 Kube-OVN 时检查这些配置是否需要调整
4. 对于关键网络功能，考虑实现监控告警机制，确保配置始终处于预期状态

总结

Kube-OVN 的外部网关功能是企业网络架构中的重要组件。通过正确的配置方式，可以避免因组件重启导致的网络中断问题。ConfigMap 配置方式不仅解决了标签重置问题，还提供了更灵活、更可靠的配置管理方法，是生产环境推荐的解决方案。