Jonline负载均衡器 Docker镜像文档

镜像概述

Jonline负载均衡器是一个专为Kubernetes环境设计的负载均衡解决方案，核心功能是提供跨多命名空间的流量分发能力，并原生支持TLS加密。通过深度集成Cert-Manager，实现SSL/TLS证书的自动化申请、更新与轮换，简化Kubernetes集群中服务暴露的安全配置流程。

核心功能与特性

• TLS协议支持：内置TLS终止（TLS Termination）功能，支持HTTPS流量处理，保障数据传输安全
• 多命名空间适配：可同时监控并管理多个Kubernetes命名空间的服务，满足复杂集群环境需求
• Cert-Manager集成：无缝对接Cert-Manager，自动完成证书申请、续期及更新，无需手动干预
• 动态配置更新：实时监听Kubernetes API，自动同步服务端点与负载均衡规则变化
• 高可用设计：支持多实例部署模式，通过健康检查机制实现故障自动转移

使用场景

• 多团队共享K8s集群：为不同团队的独立命名空间提供隔离的负载均衡规则与资源分配
• 证书自动化管理场景：需使用Let's Encrypt等免费证书服务，或企业内部PKI体系的环境
• 跨命名空间服务暴露：统一管理集群内跨命名空间的微服务入口流量，简化网络架构
• 生产级K8s环境：对服务可用性、安全性有严格要求的关键业务系统部署

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name jonline-lb \
  -v /path/to/kubeconfig:/etc/jonline/kubeconfig \
  -e KUBECONFIG_PATH=/etc/jonline/kubeconfig \
  -e WATCH_NAMESPACES=team-a,team-b,team-c \
  -e TLS_ENABLED=true \
  -e CERT_MANAGER_ISSUER=letsencrypt-prod \
  -e LOG_LEVEL=info \
  -p 80:80 -p 443:443 \
  jonline/load-***:latest

Docker Compose配置

yaml
version: '3.8'
services:
  jonline-lb:
    image: jonline/load-***:latest
    container_name: jonline-lb
    volumes:
      - ./kubeconfig:/etc/jonline/kubeconfig
    environment:
      - KUBECONFIG_PATH=/etc/jonline/kubeconfig
      - WATCH_NAMESPACES=team-a,team-b,team-c
      - TLS_ENABLED=true
      - CERT_MANAGER_ISSUER=letsencrypt-prod
      - LOG_LEVEL=info
      - HEALTH_CHECK_INTERVAL=30s
      - MAX_RETRIES=3
    ports:
      - "80:80"
      - "443:443"
    restart: unless-stopped

环境变量配置参数

持久化配置

建议将Kubernetes配置文件（kubeconfig）通过挂载卷的方式提供给容器，避免配置丢失或容器重启后需要重新配置。

证书管理

当TLS_ENABLED=true且配置了CERT_MANAGER_ISSUER时，镜像会自动与Kubernetes集群内的Cert-Manager交互，完成以下操作：

1. 为监控的命名空间创建证书申请（Certificate资源）
2. 自动续期即将过期的证书
3. 证书更新后自动重载TLS配置

注意事项

1. 确保宿主机已安装Docker且版本≥19.03
2. 挂载的kubeconfig文件需具有足够权限（至少包含对Service、Ingress、Certificate资源的读写权限）
3. 多实例部署时，需确保各实例配置一致，避免规则冲突
4. 生产环境建议配合Kubernetes StatefulSet部署，以获得更稳定的持久化与网络标识