LiteSpeed Ingress Controller Arguments¶

The LiteSpeed Ingress Controller arguments are specified in Helm with the extraArgs list or if you are creating or modifying your own .yaml files in spec/template/spec/containers/args. In YAML files, an initial leading dash is required for repeating parameters and the second double leading dash is required for all controller arguments. When using Helm extraArgs do not use leading dashes, and do use commas to separate parameters.

You can see the currently active parameters by running (for a given POD_NAME) by examining the value of Containers.Args to /ls-k8s-up.sh.

$ kubectl describe pod POD_NAME

The default Helm parameters (with https enabled) would display:

    Args:
      /ls-k8s-up.sh
      --v=2
      --allow-internal-ip=true
      --healthz-port=11972
      --lslb-debug=false
      --lslb-enable-ocsp-stapling=false
      --lslb-http-port=80
      --lslb-https-port=443

Most times these parameters are rarely changed except when requested by LiteSpeed Technical Support.

These parameters are changed within Helm using the --set extraArgs parameter. For example, if you wished to change the default-tls-secret to one created by a cert-manager with the namespace sandbox and the secret name root-secret you would specify in the helm install:

helm install ls-k8s-webadc ls-k8s-webadc/ls-k8s-webadc -n NAMESPACE --set extraArgs="{default-tls-secret=sandbox/root-secret}"

Load Balancing Controller Arguments¶

There are additional LiteSpeed Kubernetes Ingress Controller arguments which are specific to modifying the operation of the load balancer specifically. Most noteworthy are the --lslb-affinity and --lslb-strategy arguments but all of the following are important in modifying the load balancing of the controller. Note that they are specifically designed to give you the features available in the Load Balancer configuration, Clusters tab.

Metrics Specific Arguments¶

The following are additional LiteSpeed Ingress Controller Arguments used specifically to generate and use Prometheus-specific metrics using the built-in exporter.