Ingress Configuration

📘

Existing cluster resources

The ingress controller, cluster issuer, or cert-manager should only be installed if one is not currently installed in the cluster where Ketch will be installed.

In case there is already an ingress controller (Nginx, Traefik or Istio), cluster issuer or cert-manager installed in the cluster, the steps below specific to each are not necessary.

Installing Cert-Manager

If not already present in your cluster, you can install cert-manager by using the following commands:

kubectl apply -f https://github.com/jetstack/cert-manager/releases/download/v1.5.3/cert-manager.yaml

Installing Ingress Controller

Apps deployed using Ketch require an ingress controller, it uses its IP address to generate deployed application dns name that can be used to access the application

Ketch supports nginx, istio and traefik ingress controllers. See table below for supported versions of these ingress controllers.

If you have one of these ingress controllers already installed you can use them or install one or more of these. Once available you can use their IP address during ketch framework creation.

Installing Nginx ingress

If not already present in your cluster, you can run following helm command to install Nginx ingress. For details see: https://kubernetes.github.io/ingress-nginx/deploy/.

helm upgrade --install ingress-nginx ingress-nginx \
  --repo https://kubernetes.github.io/ingress-nginx \
  --namespace ingress-nginx --create-namespace

Installing Traefik ingress

If not already present in your cluster, you can install traefik using following command. For details see https://doc.traefik.io/traefik/getting-started/install-traefik/#use-the-helm-chart.

helm repo add traefik https://helm.traefik.io/traefik
helm repo update
helm install traefik traefik/traefik

Installing Istio ingress

If not already present in your cluster, you can install Istio as the ingress controller of choice by using the following commands or follow instructions at: https://istio.io/latest/docs/setup/install/

ISTIO_VERSION=1.9.0 && curl -L https://istio.io/downloadIstio |ISTIO_VERSION=1.9.0 sh - && cd istio-$ISTIO_VERSION && export PATH=$PWD/bin:$PATH

istioctl install --set profile=demo