HAProxy Kubernetes Ingress Controller

概述

HAProxy Kubernetes Ingress Controller 是一个基于 HAProxy 的 Kubernetes Ingress 控制器，主要用于将集群外部的流量路由到 Kubernetes 集群内部的服务。作为 Ingress 控制器，它负责解析 Kubernetes Ingress 资源定义的规则，动态配置 HAProxy 负载均衡器，实现 HTTP/HTTPS 流量的路由、负载均衡及流量管理。

核心功能与特性

• Ingress 资源支持：完全兼容 Kubernetes Ingress API，可基于 Ingress 资源定义的规则（如主机名、路径、HTTP 方法等）路由流量。
• 自定义注解：支持通过 Kubernetes 注解（Annotations）对 HAProxy 配置进行精细化自定义，满足复杂场景需求。
• 动态配置更新：监听 Kubernetes 集群资源变化（如 Ingress、Service、Secret 等），实时更新 HAProxy 配置，无需重启。
• 高可用性：基于 HAProxy 高性能负载均衡能力，支持多种负载均衡算法，确保服务高可用。
• SSL/TLS 终止：支持配置 SSL/TLS 证书（通过 Secret 管理），实现 HTTPS 流量的终止与加密。
• 灵活部署选项：支持通过 YAML 清单或 Helm Charts 部署，适应不同环境需求。

使用场景与适用范围

HAProxy Kubernetes Ingress Controller 适用于所有需要在 Kubernetes 集群中管理外部流量入口的场景，包括但不限于：

• 微服务架构：作为 API 网关，路由不同微服务的外部请求。
• Web 应用流量管理：处理多域名、多路径的 HTTP/HTTPS 请求分发。
• 生产环境负载均衡：利用 HAProxy 的高性能特性，为高并发服务提供稳定的流量入口。
• 需要自定义负载均衡策略：通过注解或配置调整 HAProxy 参数，满足特定业务的负载均衡需求。

使用方法与配置说明

获取镜像

*** Docker 镜像托管于 Docker Hub，可直接拉取：

bash
docker pull haproxytech/kubernetes-ingress

从源码构建镜像

若需自定义构建，可通过源码编译：

bash
# 克隆仓库（如需）
git clone [***]
cd kubernetes-ingress

# 构建镜像
docker build -t haproxytech/kubernetes-ingress -f build/Dockerfile .

部署方法

1. 使用 YAML 清单部署

基础部署可通过***提供的 YAML 清单文件完成：

bash
# 应用部署清单
kubectl apply -f [***]

该清单包含控制器的 Deployment、Service、ConfigMap 等资源定义，适用于快速启动基础功能。

2. 使用 Helm Charts 部署

***提供 Helm Charts 用于更灵活的部署与配置管理，仓库地址：haproxytech/helm-charts。

部署步骤：

bash
# 添加 Helm 仓库
helm repo add haproxytech [***]

# 更新仓库索引
helm repo update

# 部署 Ingress Controller（示例，具体参数需根据需求调整）
helm install haproxy-ingress haproxytech/kubernetes-ingress

控制器参数与自定义配置

控制器参数

控制器镜像支持多种启动参数，用于调整其行为。所有可用参数详见***文档：controller.md。

自定义配置

通过 Kubernetes 注解（Annotations）或 ConfigMap 可对 HAProxy 配置进行自定义，例如调整超时时间、启用健康检查等。详细自定义选项参见：文档。

贡献指南

欢迎参与项目贡献：

• 接受 Pull Request 贡献。
• 提交信息与代码风格请遵循 HAProxy 项目的 CONTRIBUTING 指南。
• 代码 lint 请使用 golangci-lint run（需安装 golangci-lint）。

讨论与支持

• 问题跟踪：功能需求、bug 报告等请通过 GitHub Issues 提交。
• 社区交流：可加入 HAProxy Community Slack 的 #ingress-controller 频道（加入链接），获取帮助或参与讨论。

许可证

Apache License 2.0