HAProxy Kubernetes Ingress Controller

An ingress controller is a Kubernetes resource that routes traffic from outside your cluster to services within the cluster.

Detailed documentation can be found within the Official Documentation.

You can also find in this repository a list of all available Ingress annotations.

Docker image is available on Docker Hub: haproxytech/kubernetes-ingress

If you prefer to build it from source use (change to appropriate platform if needed with TARGETPLATFORM, default platform is linux/amd64)

make build

With non default platform add appropriate TARGETPLATFORM

make build TARGETPLATFORM=linux/arm/v6

Example environment can be created with

make example

Please see controller.md for all available arguments of controller image.

Available customisations are described in doc

Basic setup to to run controller is described in yaml file.

kubectl apply -f deploy/haproxy-ingress.yaml

Official HAProxy Technologies Helm Charts for deploying on Kubernetes are available in haproxytech/helm-charts repository

Thanks for your interest in the project and your willing to contribute:

Pull requests are welcome!
For commit messages and general style please follow the haproxy project's CONTRIBUTING guide and use that where applicable.
Please use golangci-lint run from github.com/golangci/golangci-lint for linting code.

A Github issue is the right place to discuss feature requests, bug reports or any other subject that needs tracking.

To ask questions, get some help or even have a little chat, you can join our #ingress-controller channel in HAProxy Community Slack.

License