doitintl/kubeip

kubeIP 镜像文档

概述

kubeIP 是一个用于解决 Google Kubernetes Engine (GKE) 集群静态 IP 地址管理问题的工具。由于 GKE 本身不支持为集群分配静态 IP 池，许多需要基于源 IP 地址进行白名单配置的应用面临挑战。kubeIP 通过持续监控 Kubernetes API，检测节点的新增与移除，并自动从预定义的 IP 列表中为 GKE 节点分配外部 IP 地址，从而解决这一问题。

核心功能与特性

• 持续监控 Kubernetes API：实时跟踪集群节点的变化（新增、移除），确保 IP 分配及时响应节点状态变更。
• 预定义 IP 列表管理：支持从用户指定的静态 IP 列表中为节点分配外部 IP，确保 IP 地址的可控性。
• 自动化 IP 分配：无需手动干预，自动完成节点 IP 地址的分配与回收，减少运维复杂度。

使用场景与适用范围

• 需要源 IP 白名单的应用：适用于需通过源 IP 地址进行访问控制的应用，如***服务、企业内部系统等。
• GKE 集群环境：专门针对 Google Kubernetes Engine 设计，解决其静态 IP 池分配能力的不足。
• 多节点动态扩展场景：在集群节点动态扩缩容时，确保节点外部 IP 地址始终在预定义范围内，维持白名单策略有效性。

使用方法与配置说明

环境变量配置

kubeIP 支持通过环境变量进行配置，关键参数如下：

Docker 部署示例

1. 直接使用 docker run 命令

bash
docker run -d \
  --name kubeip \
  -e IP_LIST="192.168.1.10,192.168.1.11,192.168.1.12" \
  -v /path/to/kubeconfig:/root/.kube/config \
  --restart always \
  your-registry/kubeip:latest

2. 使用 docker-compose 配置

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  kubeip:
    image: your-registry/kubeip:latest
    container_name: kubeip
    environment:
      - IP_LIST=192.168.1.10,192.168.1.11,192.168.1.12
      - LOG_LEVEL=info
    volumes:
      - /path/to/kubeconfig:/root/.kube/config
    restart: always

启动服务：

bash
docker-compose up -d

注意事项

• IP 列表管理：确保预定义的 IP 列表数量不小于集群节点数量，避免 IP 分配不足。
• 权限配置：运行 kubeIP 的容器需具备访问 Kubernetes API 的权限（如通过 ClusterRole 和 ClusterRoleBinding 配置 RBAC 权限）。
• 网络策略：确保 GKE 节点所在网络允许从预定义 IP 列表分配外部 IP，且相关防火墙规则已配置。