angeloxx/cilium-haegress-operator

镜像概述

该镜像是一个专为Cilium Egress Gateway Policy设计的高可用（HA）解决方案，通过集成KubeVIP作为浮动IP（Floating IP）管理器，实现出口网关的故障转移和IP地址的动态管理，确保Kubernetes集群出口流量在节点故障时仍能保持连续性和可靠性。

核心功能和特性

• 高可用支持：通过浮动IP机制实现Cilium Egress Gateway的故障转移，主节点故障时自动将浮动IP切换至备用节点，保障出口流量不中断。
• Cilium集成：无缝对接Cilium EgressGatewayPolicy，无需修改现有Cilium配置即可增强其高可用能力。
• KubeVIP管理：采用KubeVIP作为浮动IP管理组件，支持IP地址的动态分配、释放和故障转移，兼容多种网络环境。
• 自动化IP管理：自动检测节点状态并调整浮动IP绑定，减少人工干预，降低运维复杂度。
• 轻量级部署：容器化设计，资源占用低，可快速部署于Kubernetes集群或独立Docker环境。

使用场景和适用范围

• Kubernetes集群出口高可用：适用于需要保障集群出口流量（如外部服务访问、API调用等）连续性的场景。
• Cilium CNI环境：需已部署Cilium作为Kubernetes CNI，且配置了EgressGatewayPolicy的集群。
• 生产环境可靠性要求：对出口流量中断敏感的生产环境，如电商、***、实时服务等业务系统。
• 多节点集群部署：在包含多个工作节点的Kubernetes集群中，避免因单节点故障导致出口流量中断。

使用方法和配置说明

前置条件

1. 已部署Kubernetes集群（建议v1.24+）
2. 已安装Cilium（建议v1.13+）并配置EgressGatewayPolicy
3. 已部署KubeVIP（建议v0.5.0+），且具备浮动IP管理权限
4. 具备浮动IP地址池（需与集群网络打通，确保外部可达）

配置参数

该镜像通过环境变量进行配置，主要参数如下：

部署示例

Docker Run部署（独立环境）

bash
docker run -d \
  --name cilium-egress-ha \
  --net=host \
  -e FLOATING_IP=192.168.1.100 \
  -e INTERFACE=eth0 \
  -e CILIUM_EGRESS_POLICY_NAME=egress-policy \
  -v /etc/kubernetes/admin.conf:/etc/kubernetes/admin.conf \
  [镜像名称]:[版本标签]

Kubernetes Deployment部署

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: cilium-egress-ha
  namespace: kube-system
spec:
  replicas: 2  # 至少2副本以实现高可用
  selector:
    matchLabels:
      app: cilium-egress-ha
  template:
    metadata:
      labels:
        app: cilium-egress-ha
    spec:
      hostNetwork: true
      containers:
      - name: cilium-egress-ha
        image: docker.xuanyuan.run/[镜像名称]:[版本标签]
        env:
        - name: FLOATING_IP
          value: "192.168.1.100"
        - name: INTERFACE
          value: "eth0"
        - name: CILIUM_EGRESS_POLICY_NAME
          value: "egress-policy"
        - name: CHECK_INTERVAL
          value: "5"
        volumeMounts:
        - name: kubeconfig
          mountPath: /etc/kubernetes/admin.conf
          readOnly: true
      volumes:
      - name: kubeconfig
        hostPath:
          path: /etc/kubernetes/admin.conf

注意事项

• 确保浮动IP地址在集群网络中未被其他设备占用
• KubeVIP需配置RBAC权限，允许管理节点网络接口和IP地址
• Cilium EgressGatewayPolicy需提前创建，且指定的出口节点与解决方案部署节点一致
• 多副本部署时建议分布在不同节点，避免单点故障