README
¶
HAProxy Unified Gateway for Kubernetes
Description
HUG provides a free open-source solution for cloud-native application routing, featuring unified integration with the latest Kubernetes Gateway API and (coming next year) the existing Ingress API, all built on HAProxy’s legendary performance, reliability, and flexibility – so you can trust it to operate dependably at the largest scale.
Current releases are considered BETA as they do not yet provide full coverage of the Gateway API.
Usage
Docker image is available on Docker Hub
If you prefer to build it from source use
task kind-build-controller-image-build-in-docker
Example environment can be created with
task kind-create
or
task k0s-create
Examples
Examples about deployment can be seen in example folder.
HAProxy Helm Charts
helm Chart are planned and will be available with 1.0 version
Contributing
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
task lintfor linting code.
Discussion
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
Directories
¶
| Path | Synopsis |
|---|---|
|
api
|
|
|
gate/v3
+groupName=gate.v3.haproxy.org +k8s:deepcopy-gen=package
|
+groupName=gate.v3.haproxy.org +k8s:deepcopy-gen=package |
|
cmd
|
|
|
controller
command
|
|
|
crd-version-check
command
|
|
|
doc-options
command
|
|
|
generate-gwapi
command
generate-gwapi reads the GWAPI_VERSIONS environment variable and regenerates all files that depend on the list of supported Gateway API versions:
|
generate-gwapi reads the GWAPI_VERSIONS environment variable and regenerates all files that depend on the list of supported Gateway API versions: |
|
gitlab-mr-pipelines
command
|
|
|
metrics-report
command
metrics-report reads HUG integration test metrics samples (JSONL files), generates PNG charts, uploads them to GitLab, and posts an MR comment with embedded chart images — one section per test suite.
|
metrics-report reads HUG integration test metrics samples (JSONL files), generates PNG charts, uploads them to GitLab, and posts an MR comment with embedded chart images — one section per test suite. |
|
fs
|
|
|
hug
|
|
|
k8s
|
|
|
gate
Package controller is the core of the HAProxy Kubernetes Gateway Controller.
|
Package controller is the core of the HAProxy Kubernetes Gateway Controller. |
|
gate/utils
Package utils provides utility functions for key mapping and conversions.
|
Package utils provides utility functions for key mapping and conversions. |
|
test
|
|