LoxiLB项目中手动配置VIP IP的技术实践指南

前言

在Kubernetes环境中使用自定义VIP（虚拟IP）地址是许多企业级应用场景的常见需求。本文将详细介绍如何在LoxiLB项目中正确配置和使用自定义VIP地址，以及相关的网络配置注意事项。

正确配置静态VIP地址

在LoxiLB项目中，要为Kubernetes服务指定静态VIP地址，需要使用特定的注解格式。常见的错误是使用loxilb.io/vip注解，这不会生效。正确的做法是：

metadata:
  annotations:
    loxilb.io/staticIP: "10.1.3.1"

这个注解会确保服务使用指定的IP地址而不是自动分配的地址。完整的服务定义示例如下：

apiVersion: v1
kind: Service
metadata:
  name: tcp-lb-onearm
  annotations:
    loxilb.io/staticIP: "10.1.3.1"
    loxilb.io/liveness: "yes"
    loxilb.io/lbmode: "onearm"
spec:
  externalTrafficPolicy: Local
  loadBalancerClass: loxilb.io/loxilb
  selector:
    what: tcp-onearm-test
  ports:
    - port: 55002
      targetPort: 80
  type: LoadBalancer

网络端点配置选项

LoxiLB提供了多种端点配置方式，根据不同的网络需求可以选择：

1. 默认NodePort模式：流量首先负载均衡到NodePort，然后由Kubernetes节点转发到Pod
2. 直接Pod网络模式：通过添加注解loxilb.io/usepodnetwork: "yes"，端点将直接设置为Pod IP

常见问题排查

当配置VIP后出现连接问题时，建议按照以下步骤排查：

1. 基础连通性检查：

   • 确认可以ping通VIP地址
   • 检查路由表中是否有正确的路由条目

2. LoxiLB配置验证：

   • 确认VIP地址已正确添加到LoxiLB的lo接口
   • 检查LoxiLB的负载均衡规则是否正确配置

3. 网络模式选择：

   • 在单臂模式(onearm)下，确保外部IP配置正确
   • 可以尝试使用LoxiLB所在节点的网络范围内的IP地址进行测试

与API网关的集成

当LoxiLB与第三方API网关(如kgateway)一起使用时，需要注意：

1. 如果使用Gateway API的HTTPRoute，LoxiLB的ingress模块会处理HTTPS流量，需要准备SSL证书
2. kgateway可能有自己的Gateway API实现，需要评估整体架构设计
3. 可以通过TCPRoute配置来实现特定协议的流量转发

手动创建负载均衡规则

除了通过Kubernetes注解配置外，还可以直接使用loxicmd命令行工具创建负载均衡规则：

loxicmd create lb 192.168.0.200 --tcp=80:32015 --endpoints=10.212.0.1:1,10.212.0.2:1,10.212.0.3:1 --mode=fullnat

参数说明：

• --tcp=80:32015：指定外部端口和内部目标端口
• --endpoints：后端端点列表，格式为IP:权重
• --mode：支持onearm(单臂)或fullnat(全NAT)模式

虚拟化环境注意事项

LoxiLB可以部署在物理服务器或虚拟机上。在VMware vSphere等虚拟化环境中使用时，需要确保：

1. 虚拟网络配置正确，允许VIP地址的流量到达LoxiLB实例
2. 虚拟机的网络接口有足够的性能处理预期的流量负载
3. 虚拟交换机配置不会过滤或限制必要的网络流量

总结

正确配置LoxiLB的自定义VIP地址需要理解注解的正确用法、网络模式的差异以及相关的排查方法。通过本文介绍的最佳实践，可以确保在Kubernetes环境中高效、可靠地使用LoxiLB实现自定义VIP地址的负载均衡服务。