Internal documentation only

This page has been marked as draft.

Ingress controllers

Important

This information refers to the previous helm install method for the ITRS Analytics Platform. If you are looking to install using the more streamlined Kubernetes Off-the-Shelf (KOTS) method, see the updated installation overview.

You need an ingress controller in your Kubernetes cluster. You can use the following for ITRS Analytics:

NGINX ingress controller Copied

Installation Copied

Note

If you are installing on OpenShift OKD, you need to do the steps in Install on OpenShift OKD > Install ingress-nginx instead.

If you opt to install the ingress-nginx controller in your Kubernetes cluster, follow these steps.

  1. Add the ingress-nginx Helm repo:

    helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
    

    Or update the repo if it already exists:

    helm repo update
    
  2. Install the controller in the ITRS Analytics namespace:

    helm install ingress-nginx ingress-nginx/ingress-nginx -n itrs
    

Configuration Copied

Add the following annotation definitions to your ITRS Analytics configuration file:

  apps:
    ingress:
      annotations:
        kubernetes.io/ingress.class: "nginx"
        nginx.org/mergeable-ingress-type: "master"
  ingestion:
    ingress:
      annotations:
        kubernetes.io/ingress.class: "nginx"
        nginx.ingress.kubernetes.io/backend-protocol: "GRPC"
  iam:
    ingress:
      annotations:
        kubernetes.io/ingress.class: "nginx"
        nginx.org/mergeable-ingress-type: "minion"

HAProxy ingress controller Copied

Configuration Copied

If you opt to use the HAProxy controller in your Kubernetes cluster, add the following annotation definitions to your ITRS Analytics configuration file:

  apps:
    ingress:
      annotations:
        kubernetes.io/ingress.class: "haproxy"
  ingestion:
    ingress:
      annotations:
        kubernetes.io/ingress.class: "haproxy"
        ingress.kubernetes.io/backend-protocol: h2
  iam:
    ingress:
      annotations:
        kubernetes.io/ingress.class: "haproxy"
["ITRS Analytics"] ["User Guide", "Technical Reference"]

Was this topic helpful?