haproxy

# This file has been modified by Chainguard, Inc.

#

# Copyright Chainguard, Inc. All Rights Reserved.

# Chainguard, Inc. modifications are subject to the license

# available at: https://www.chainguard.dev/legal/software-license-agreement

#

# Copyright Broadcom, Inc. All Rights Reserved.

# SPDX-License-Identifier: APACHE-2.0

## @section Global parameters

## Global Docker image parameters

## Please, note that this will override the image parameters, including dependencies, configured to use the global value

## Current available global Docker image parameters: imageRegistry, imagePullSecrets and storageClass

##

## @param global.imageRegistry Global Docker image registry

## @param global.useImageTags Pull every image by tag and ignore all image digests, including digests set in values. Use this when your registry mirror does not have the chart's default image digests.

## @param global.imagePullSecrets Global Docker registry secret names as an array

## @param global.defaultStorageClass Global default StorageClass for Persistent Volume(s)

## @param global.storageClass DEPRECATED: use global.defaultStorageClass instead

##

global:

imageRegistry: ""

useImageTags: false

## E.g.

## imagePullSecrets:

## - myRegistryKeySecretName

##

imagePullSecrets: []

defaultStorageClass: ""

storageClass: ""

## Security parameters

##

security:

## @param global.security.allowInsecureImages Allows skipping image verification

allowInsecureImages: false

## Compatibility adaptations for Kubernetes platforms

##

compatibility:

## Compatibility adaptations for Openshift

##

openshift:

## @param global.compatibility.openshift.adaptSecurityContext Adapt the securityContext sections of the deployment to make them compatible with Openshift restricted-v2 SCC: remove runAsUser, runAsGroup and fsGroup and let the platform use their allowed default IDs. Possible values: auto (apply if the detected running cluster is Openshift), force (perform the adaptation always), disabled (do not perform adaptation)

##

adaptSecurityContext: auto

org: ""

## @section Common parameters

##

## @param kubeVersion Override Kubernetes version

##

kubeVersion: ""

## @param nameOverride String to partially override common.names.fullname

##

nameOverride: ""

## @param fullnameOverride String to fully override common.names.fullname

##

fullnameOverride: ""

## @param commonLabels Labels to add to all deployed objects

##

commonLabels: {}

## @param commonAnnotations Annotations to add to all deployed objects

##

commonAnnotations: {}

## @param clusterDomain Kubernetes cluster domain name

##

clusterDomain: cluster.local

## @param extraDeploy Array of extra objects to deploy with the release

##

extraDeploy: []

## @param deploymentAnnotations Annotations to add to the deployment

##

deploymentAnnotations: {}

## Enable diagnostic mode in the deployment

##

diagnosticMode:

## @param diagnosticMode.enabled Enable diagnostic mode (all probes will be disabled and the command will be overridden)

##

enabled: false

## @param diagnosticMode.command Command to override all containers in the deployment

##

command:

- sleep

## @param diagnosticMode.args Args to override all containers in the deployment

##

args:

- infinity

## @section Traffic Exposure Parameters

##

## haproxy service parameters

##

service:

## @param service.type haproxy service type

##

type: LoadBalancer

## @param service.ports [array] List of haproxy service ports

##

ports:

- name: http

protocol: TCP

port: 80

targetPort: http

## @param service.clusterIP haproxy service Cluster IP

## e.g.:

## clusterIP: None

##

clusterIP: ""

## @param service.loadBalancerIP haproxy service Load Balancer IP

## ref: https://kubernetes.io/docs/concepts/services-networking/service/#type-loadbalancer

##

loadBalancerIP: ""

## @param service.loadBalancerSourceRanges haproxy service Load Balancer sources

## ref: https://kubernetes.io/docs/tasks/access-application-cluster/configure-cloud-provider-firewall/#restrict-access-for-loadbalancer-service

## e.g:

## loadBalancerSourceRanges:

## - 10.10.10.0/24

##

loadBalancerSourceRanges: []

## @param service.externalTrafficPolicy haproxy service external traffic policy

## ref https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/#preserving-the-client-source-ip

##

## @param service.externalIPs [array] External IPs

## ref: https://kubernetes.io/docs/concepts/services-networking/service/#external-ips

##

externalIPs: []

externalTrafficPolicy: Cluster

## @param service.annotations Additional custom annotations for haproxy service

##

annotations: {}

## @param service.sessionAffinity Session Affinity for Kubernetes service, can be "None" or "ClientIP"

## If "ClientIP", consecutive client requests will be directed to the same mongos Pod

## ref: https://kubernetes.io/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies

##

sessionAffinity: None

## @param service.sessionAffinityConfig Additional settings for the sessionAffinity

## sessionAffinityConfig:

## clientIP:

## timeoutSeconds: 300

##

sessionAffinityConfig: {}

## @param service.labels Additional custom labels for haproxy service

##

labels: {}

## @param service.ipFamilyPolicy IP family policy for the service

## Allowed values: SingleStack, PreferDualStack, RequireDualStack

## ref: https://kubernetes.io/docs/concepts/services-networking/dual-stack/#services

##

ipFamilyPolicy: ""

## @param service.ipFamilies IP families for the service

## Allowed values: IPv4, IPv6

## ref: https://kubernetes.io/docs/concepts/services-networking/dual-stack/#services

## e.g:

## ipFamilies:

## - IPv4

## - IPv6

##

ipFamilies: []

## Network Policies

## Ref: https://kubernetes.io/docs/concepts/services-networking/network-policies/

##

networkPolicy:

## @param networkPolicy.enabled Specifies whether a NetworkPolicy should be created

##

enabled: true

## @param networkPolicy.allowExternal Don't require server label for connections

## The Policy model to apply. When set to false, only pods with the correct

## server label will have network access to the ports server is listening

## on. When true, server will accept connections from any source

## (with the correct destination port).

##

allowExternal: true

## @param networkPolicy.allowExternalEgress Allow the pod to access any range of port and all destinations.

##

allowExternalEgress: true

## @param networkPolicy.extraIngress [array] Add extra ingress rules to the NetworkPolicy

## e.g:

## extraIngress:

## - ports:

## - port: 1234

## from:

## - podSelector:

## - matchLabels:

## - role: frontend

## - podSelector:

## - matchExpressions:

## - key: role

## operator: In

## values:

## - frontend

extraIngress: []

## @param networkPolicy.extraEgress [array] Add extra ingress rules to the NetworkPolicy

## e.g:

## extraEgress:

## - ports:

## - port: 1234

## to:

## - podSelector:

## - matchLabels:

## - role: frontend

## - podSelector:

## - matchExpressions:

## - key: role

## operator: In

## values:

## - frontend

##

extraEgress: []

## @param networkPolicy.ingressNSMatchLabels [object] Labels to match to allow traffic from other namespaces

## @param networkPolicy.ingressNSPodMatchLabels [object] Pod labels to match to allow traffic from other namespaces

##

ingressNSMatchLabels: {}

ingressNSPodMatchLabels: {}

## Configure the ingress resource that allows you to access the haproxy installation

## ref: https://kubernetes.io/docs/concepts/services-networking/ingress/

##

ingress:

## @param ingress.enabled Enable ingress record generation for haproxy

##

enabled: false

## @param ingress.pathType Ingress path type

##

pathType: ImplementationSpecific

## @param ingress.apiVersion Force Ingress API version (automatically detected if not set)

##

apiVersion: ""

## @param ingress.hostname Default host for the ingress record

##

hostname: haproxy.local

## @param ingress.path Default path for the ingress record

## NOTE: You may need to set this to '/*' in order to use this with ALB ingress controllers

##

path: /

## @param ingress.annotations Additional annotations for the Ingress resource. To enable certificate autogeneration, place here your cert-manager annotations.

## For a full list of possible ingress annotations, please see

## ref: https://github.com/kubernetes/ingress-nginx/blob/main/docs/user-guide/nginx-configuration/annotations.md

## Use this parameter to set the required annotations for cert-manager, see

## ref: https://cert-manager.io/docs/usage/ingress/#supported-annotations

##

## e.g:

## annotations:

## kubernetes.io/ingress.class: nginx

## cert-manager.io/cluster-issuer: cluster-issuer-name

##

annotations: {}

## @param ingress.tls Enable TLS configuration for the host defined at `ingress.hostname` parameter

## TLS certificates will be retrieved from a TLS secret with name: `{{- printf "%s-tls" .Values.ingress.hostname }}`

## You can:

## - Use the `ingress.secrets` parameter to create this TLS secret

## - Rely on cert-manager to create it by setting the corresponding annotations

## - Rely on Helm to create self-signed certificates by setting `ingress.selfSigned=true`

##

tls: false

## DEPRECATED: Use ingress.annotations instead of ingress.certManager

## certManager: false

##

## @param ingress.selfSigned Create a TLS secret for this ingress record using self-signed certificates generated by Helm

##

selfSigned: false

## @param ingress.extraHosts An array with additional hostname(s) to be covered with the ingress record

## e.g:

## extraHosts:

## - name: haproxy.local

## path: /

##

extraHosts: []

## @param ingress.extraPaths An array with additional arbitrary paths that may need to be added to the ingress under the main host

## e.g:

## extraPaths:

## - path: /*

## backend:

## serviceName: ssl-redirect

## servicePort: use-annotation

##

extraPaths: []

## @param ingress.extraTls TLS configuration for additional hostname(s) to be covered with this ingress record

## ref: https://kubernetes.io/docs/concepts/services-networking/ingress/#tls

## e.g:

## extraTls:

## - hosts:

## - haproxy.local

## secretName: haproxy.local-tls

##

extraTls: []

## @param ingress.secrets Custom TLS certificates as secrets

## NOTE: 'key' and 'certificate' are expected in PEM format

## NOTE: 'name' should line up with a 'secretName' set further up

## If it is not set and you're using cert-manager, this is unneeded, as it will create a secret for you with valid certificates

## If it is not set and you're NOT using cert-manager either, self-signed certificates will be created valid for 365 days

## It is also possible to create and manage the certificates outside of this helm chart

## Please see README.md for more information

## e.g:

## secrets:

## - name: haproxy.local-tls

## key: |-

## -----BEGIN RSA PRIVATE KEY-----

## ...

## -----END RSA PRIVATE KEY-----

## certificate: |-

## -----BEGIN CERTIFICATE-----

## ...

## -----END CERTIFICATE-----

##

secrets: []

## @param ingress.ingressClassName IngressClass that will be be used to implement the Ingress (Kubernetes 1.18+)

## This is supported in Kubernetes 1.18+ and required if you have more than one IngressClass marked as the default for your cluster .

## ref: https://kubernetes.io/blog/2020/04/02/improvements-to-the-ingress-api-in-kubernetes-1.18/

##

ingressClassName: ""

## @param ingress.extraRules Additional rules to be covered with this ingress record

## ref: https://kubernetes.io/docs/concepts/services-networking/ingress/#ingress-rules

## e.g:

## extraRules:

## - host: example.local

## http:

## path: /

## backend:

## service:

## name: example-svc

## port:

## name: http

##

extraRules: []

## @param terminationGracePeriodSeconds Seconds HAProxy pod needs to terminate gracefully

## ref: https://kubernetes.io/docs/concepts/workloads/pods/pod/#termination-of-pods

terminationGracePeriodSeconds: ""

## @section HAProxy Parameters

##

## @param image.registry [default: REGISTRY_NAME] HAProxy image registry

## @param image.repository [default: REPOSITORY_NAME/haproxy] HAProxy image repository

## @skip image.tag HAProxy image tag (immutable tags are recommended)

## @param image.digest HAProxy image digest in the way sha256:aa.... Please note this parameter, if set, will override the tag

## @param image.pullPolicy HAProxy image pull policy

## @param image.pullSecrets HAProxy image pull secrets

##

image:

registry: cgr.dev

repository: chainguard-private/haproxy-iamguarded

tag: 3.4.7

digest: sha256:4f9438b2c3318714da77741c394ddd17c86b610601000ee6910f62d3f5cfa43d

## Specify a imagePullPolicy

## ref: https://kubernetes.io/docs/concepts/containers/images/#pre-pulled-images

##

pullPolicy: IfNotPresent

## Optionally specify an array of imagePullSecrets.

## Secrets must be manually created in the namespace.

## ref: https://kubernetes.io/docs/tasks/configure-pod-container/pull-image-private-registry/

## e.g:

## pullSecrets:

## - myRegistryKeySecretName

##

pullSecrets: []

## @param replicaCount Number of haproxy replicas to deploy

##

replicaCount: 1

## Configure extra options for haproxy containers' liveness and readiness probes

## ref: https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-probes/#configure-probes

## @param startupProbe.enabled Enable startupProbe on haproxy nodes

## @param startupProbe.initialDelaySeconds Initial delay seconds for startupProbe

## @param startupProbe.periodSeconds Period seconds for startupProbe

## @param startupProbe.timeoutSeconds Timeout seconds for startupProbe

## @param startupProbe.failureThreshold Failure threshold for startupProbe

## @param startupProbe.successThreshold Success threshold for startupProbe

##

startupProbe:

enabled: false

failureThreshold: 5

initialDelaySeconds: 15

periodSeconds: 10

successThreshold: 1

timeoutSeconds: 5

## @param livenessProbe.enabled Enable livenessProbe on haproxy nodes

## @param livenessProbe.initialDelaySeconds Initial delay seconds for livenessProbe

## @param livenessProbe.periodSeconds Period seconds for livenessProbe

## @param livenessProbe.timeoutSeconds Timeout seconds for livenessProbe

## @param livenessProbe.failureThreshold Failure threshold for livenessProbe

## @param livenessProbe.successThreshold Success threshold for livenessProbe

##

livenessProbe:

enabled: true

failureThreshold: 5

initialDelaySeconds: 15

periodSeconds: 10

successThreshold: 1

timeoutSeconds: 5

## @param readinessProbe.enabled Enable readinessProbe on haproxy nodes

## @param readinessProbe.initialDelaySeconds Initial delay seconds for readinessProbe

## @param readinessProbe.periodSeconds Period seconds for readinessProbe

## @param readinessProbe.timeoutSeconds Timeout seconds for readinessProbe

## @param readinessProbe.failureThreshold Failure threshold for readinessProbe

## @param readinessProbe.successThreshold Success threshold for readinessProbe

##

readinessProbe:

enabled: true

failureThreshold: 5

initialDelaySeconds: 15

periodSeconds: 10

successThreshold: 1

timeoutSeconds: 5

## @param customStartupProbe Custom startupProbe that overrides the default one

##

customStartupProbe: {}

## @param customLivenessProbe Custom livenessProbe that overrides the default one

##

customLivenessProbe: {}

## @param customReadinessProbe Custom readinessProbe that overrides the default one

##

customReadinessProbe: {}

## haproxy resource requests and limits

## ref: https://kubernetes.io/docs/concepts/configuration/manage-compute-resources-container/

## @param resourcesPreset Set container resources according to one common preset (allowed values: none, nano, micro, small, medium, large, xlarge, 2xlarge). This is ignored if resources is set (resources is recommended for production).

##

resourcesPreset: "nano"

## @param resources Set container requests and limits for different resources like CPU or memory (essential for production workloads)

## Example:

## resources:

## requests:

## cpu: 2

## memory: 512Mi

## limits:

## cpu: 3

## memory: 1024Mi

##

resources: {}

## Configure Pods Security Context

## ref: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-pod

## @param podSecurityContext.enabled Enabled haproxy pods' Security Context

## @param podSecurityContext.fsGroupChangePolicy Set filesystem group change policy

## @param podSecurityContext.sysctls Set kernel settings using the sysctl interface

## @param podSecurityContext.supplementalGroups Set filesystem extra groups

## @param podSecurityContext.fsGroup Set haproxy pod's Security Context fsGroup

##

podSecurityContext:

enabled: true

fsGroupChangePolicy: Always

sysctls: []

supplementalGroups: []

fsGroup: 1001

## Configure Container Security Context

## ref: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-pod

## @param containerSecurityContext.enabled Enabled containers' Security Context

## @param containerSecurityContext.seLinuxOptions [object,nullable] Set SELinux options in container

## @param containerSecurityContext.runAsUser Set containers' Security Context runAsUser

## @param containerSecurityContext.runAsGroup Set containers' Security Context runAsGroup

## @param containerSecurityContext.runAsNonRoot Set container's Security Context runAsNonRoot

## @param containerSecurityContext.privileged Set container's Security Context privileged

## @param containerSecurityContext.readOnlyRootFilesystem Set container's Security Context readOnlyRootFilesystem

## @param containerSecurityContext.allowPrivilegeEscalation Set container's Security Context allowPrivilegeEscalation

## @param containerSecurityContext.capabilities.drop List of capabilities to be dropped

## @param containerSecurityContext.seccompProfile.type Set container's Security Context seccomp profile

##

containerSecurityContext:

enabled: true

seLinuxOptions: {}

runAsUser: 1001

runAsGroup: 1001

runAsNonRoot: true

privileged: false

readOnlyRootFilesystem: true

allowPrivilegeEscalation: false

capabilities:

drop: ["ALL"]

add: ["NET_BIND_SERVICE"]

seccompProfile:

type: "RuntimeDefault"

## HAProxy Pod Disruption Budget configuration

## ref: https://kubernetes.io/docs/tasks/run-application/configure-pdb/

## @param pdb.create Enable a Pod Disruption Budget creation

## @param pdb.minAvailable Minimum number/percentage of pods that should remain scheduled

## @param pdb.maxUnavailable Maximum number/percentage of pods that may be made unavailable

##

pdb:

create: true

minAvailable: ""

maxUnavailable: ""

## HAProxy Autoscaling configuration

## ref: https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/

## @param autoscaling.enabled Enable Horizontal POD autoscaling for HAProxy

## @param autoscaling.minReplicas Minimum number of HAProxy replicas

## @param autoscaling.maxReplicas Maximum number of HAProxy replicas

## @param autoscaling.targetCPU Target CPU utilization percentage

## @param autoscaling.targetMemory Target Memory utilization percentage

##

autoscaling:

enabled: false

minReplicas: 1

maxReplicas: 11

targetCPU: 50

targetMemory: 50

## @param command Override default container command (useful when using custom images)

##

command: []

## @param args Override default container args (useful when using custom images)

##

args: []

## @param automountServiceAccountToken Mount Service Account token in pod

##

automountServiceAccountToken: false

## @param hostAliases haproxy pods host aliases

## https://kubernetes.io/docs/concepts/services-networking/add-entries-to-pod-etc-hosts-with-host-aliases/

##

hostAliases: []

## @param podLabels Extra labels for haproxy pods

## ref: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/

##

podLabels: {}

## @param podAnnotations Annotations for haproxy pods

## ref: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/

##

podAnnotations: {}

## @param podAffinityPreset Pod affinity preset. Ignored if `affinity` is set. Allowed values: `soft` or `hard`

## ref: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#inter-pod-affinity-and-anti-affinity

##

podAffinityPreset: ""

## @param podAntiAffinityPreset Pod anti-affinity preset. Ignored if `affinity` is set. Allowed values: `soft` or `hard`

## ref: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#inter-pod-affinity-and-anti-affinity

##

podAntiAffinityPreset: soft

## Node affinity preset

## ref: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/#node-affinity

##

nodeAffinityPreset:

## @param nodeAffinityPreset.type Node affinity preset type. Ignored if `affinity` is set. Allowed values: `soft` or `hard`

##

type: ""

## @param nodeAffinityPreset.key Node label key to match. Ignored if `affinity` is set

##

key: ""

## @param nodeAffinityPreset.values Node label values to match. Ignored if `affinity` is set

## E.g.

## values:

## - e2e-az1

## - e2e-az2

##

values: []

## @param configuration [string] haproxy configuration

## Taken from haproxytech/haproxy chart: https://github.com/haproxytech/helm-charts/tree/main/haproxy

##

configuration: |

global

log stdout format raw local0

maxconn 1024

defaults

log global

timeout client 60s

timeout connect 60s

timeout server 60s

frontend fe_main

bind :8080

default_backend be_main

backend be_main

server web1 10.0.0.1:8080 check

## @param containerPorts [array] List of container ports to enable in the haproxy container

##

containerPorts:

- name: http

containerPort: 8080

## @param existingConfigmap configmap with HAProxy configuration

##

existingConfigmap: ""

## @param affinity Affinity for haproxy pods assignment

## ref: https://kubernetes.io/docs/concepts/configuration/assign-pod-node/#affinity-and-anti-affinity

## NOTE: `podAffinityPreset`, `podAntiAffinityPreset`, and `nodeAffinityPreset` will be ignored when it's set

##

affinity: {}

## @param nodeSelector Node labels for haproxy pods assignment

## ref: https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/

##

nodeSelector: {}

## @param tolerations Tolerations for haproxy pods assignment

## ref: https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/

##

tolerations: []

## @param schedulerName Name of the k8s scheduler (other than default)

## ref: https://kubernetes.io/docs/tasks/administer-cluster/configure-multiple-schedulers/

##

schedulerName: ""

## @param topologySpreadConstraints Topology Spread Constraints for pod assignment

## https://kubernetes.io/docs/concepts/workloads/pods/pod-topology-spread-constraints/

## The value is evaluated as a template

##

topologySpreadConstraints: []

## @param updateStrategy.type haproxy statefulset strategy type

## ref: https://kubernetes.io/docs/concepts/workloads/controllers/statefulset/#update-strategies

##

updateStrategy:

## StrategyType

## Can be set to RollingUpdate or OnDelete

##

type: RollingUpdate

## @param priorityClassName haproxy pods' priorityClassName

##

priorityClassName: ""

## @param lifecycleHooks for the haproxy container(s) to automate configuration before or after startup

##

lifecycleHooks: {}

## @param extraEnvVars Array with extra environment variables to add to haproxy nodes

## e.g:

## extraEnvVars:

## - name: FOO

## value: "bar"

##

extraEnvVars: []

## @param extraEnvVarsCM Name of existing ConfigMap containing extra env vars for haproxy nodes

##

extraEnvVarsCM: ""

## @param extraEnvVarsSecret Name of existing Secret containing extra env vars for haproxy nodes

##

extraEnvVarsSecret: ""

## @param extraVolumes Optionally specify extra list of additional volumes for the haproxy pod(s)

##

extraVolumes: []

## @param extraVolumeMounts Optionally specify extra list of additional volumeMounts for the haproxy container(s)

##

extraVolumeMounts: []

## @param sidecars Add additional sidecar containers to the haproxy pod(s)

## e.g:

## sidecars:

## - name: your-image-name

## image: your-image

## imagePullPolicy: Always

## ports:

## - name: portname

## containerPort: 1234

##

sidecars: []

## @param initContainers Add additional init containers to the haproxy pod(s)

## ref: https://kubernetes.io/docs/concepts/workloads/pods/init-containers/

## e.g:

## initContainers:

## - name: your-image-name

## image: your-image

## imagePullPolicy: Always

## command: ['sh', '-c', 'echo "hello world"']

##

initContainers: []

## @section Other Parameters

##

## ServiceAccount configuration

## ref: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/

## @param serviceAccount.create Specifies whether a ServiceAccount should be created

## @param serviceAccount.name Name of the service account to use. If not set and create is true, a name is generated using the fullname template.

## @param serviceAccount.automountServiceAccountToken Automount service account token for the server service account

## @param serviceAccount.annotations Annotations for service account. Evaluated as a template. Only used if `create` is `true`.

##

serviceAccount:

## @param serviceAccount.create Specifies whether a ServiceAccount should be created

##

create: true

## @param serviceAccount.name The name of the ServiceAccount to use.

## If not set and create is true, a name is generated using the common.names.fullname template

##

name: ""

automountServiceAccountToken: false

annotations: {}

## @param enableServiceLinks If set to false, disable Kubernetes service links in the pod spec

## Ref: https://kubernetes.io/docs/tutorials/services/connect-applications-service/#accessing-the-service

##

enableServiceLinks: true