haproxytech/kubernetes-ingress

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 https://github.com/haproxytech/kubernetes-ingress.git
cd kubernetes-ingress

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

部署方法

1. 使用 YAML 清单部署

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

bash
# 应用部署清单
kubectl apply -f https://raw.githubusercontent.com/haproxytech/kubernetes-ingress/master/deploy/haproxy-ingress.yaml

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

2. 使用 Helm Charts 部署

官方提供 Helm Charts 用于更灵活的部署与配置管理，仓库地址：https://github.com/haproxytech/helm-charts%E3%80%82

部署步骤：

bash
# 添加 Helm 仓库
helm repo add haproxytech https://haproxytech.github.io/helm-charts

# 更新仓库索引
helm repo update

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

控制器参数与自定义配置

控制器参数

控制器镜像支持多种启动参数，用于调整其行为。所有可用参数详见官方文档：https://github.com/haproxytech/kubernetes-ingress/blob/master/documentation/controller.md%E3%80%82

自定义配置

通过 Kubernetes 注解（Annotations）或 ConfigMap 可对 HAProxy 配置进行自定义，例如调整超时时间、启用健康检查等。详细自定义选项参见：https://github.com/haproxytech/kubernetes-ingress/blob/master/documentation/README.md%E3%80%82

贡献指南

欢迎参与项目贡献：

• 接受 Pull Request 贡献。
• 提交信息与代码风格请遵循 HAProxy 项目的 https://github.com/haproxy/haproxy/blob/master/CONTRIBUTING%E3%80%82
• 代码 lint 请使用 golangci-lint run（需安装 https://github.com/golangci/golangci-lint%EF%BC%89%E3%80%82

讨论与支持

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

许可证

https://github.com/haproxytech/kubernetes-ingress/blob/master/LICENSE