Skip to main content

Helm 3

Helm is a package manager for Kubernetes. It allows you to install and manage applications on Kubernetes.

Setup EasyHAProxy with Helm 3​

1) Install EasyHAProxy​

Add the Helm repository
helm repo add byjg https://opensource.byjg.com/helm
helm repo update byjg
kubectl create namespace easyhaproxy
Install with Helm
helm upgrade --install ingress byjg/easyhaproxy \
    --namespace easyhaproxy \
    --set resources.requests.cpu=100m \
    --set resources.requests.memory=128Mi

2) Choose a deployment mode​

By default, EasyHAProxy installs as a DaemonSet (service.create: false). To use the recommended NodePort or ClusterIP modes instead, set service.create: true:

NodePort (recommended)
helm upgrade --install ingress byjg/easyhaproxy \
    --namespace easyhaproxy \
    --set service.create=true \
    --set service.type=NodePort
ClusterIP (behind LoadBalancer)
helm upgrade --install ingress byjg/easyhaproxy \
    --namespace easyhaproxy \
    --set service.create=true \
    --set service.type=ClusterIP
LoadBalancer (cloud providers)
helm upgrade --install ingress byjg/easyhaproxy \
    --namespace easyhaproxy \
    --set service.create=true \
    --set service.type=LoadBalancer

On a cloud provider (DigitalOcean, AWS, GCP, Azure…), LoadBalancer asks the provider for an external load balancer in front of EasyHAProxy, and its address is written to your Ingress status. Use service.annotations for provider-specific load balancer settings.

3) Persist ACME certificates​

If you use automatic certificates (easyhaproxy.certbot annotation), set the ACME e-mail and keep the issued certificates on a volume:

ACME with persisted certificates
helm upgrade --install ingress byjg/easyhaproxy \
    --namespace easyhaproxy \
    --set service.create=true \
    --set service.type=LoadBalancer \
    --set [email protected] \
    --set persistence.certbot.enabled=true

See Deployment Modes for a comparison of all three modes.

For the complete list of configurable values, see the Helm Values reference.

Open source ByJG