Install the Nginx Ingress Controller

This practical sheets is given as information only, Nginx is not mandatory at all, you are free to install any other Ingress Controler on your clusters. No support can be provided on Nginx.

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

We recommend disabling the usage of the option controller.service.appProtocol to utilize a basic L4 load balancer instead of an L7 load balancer in vCloud Director. By doing so, the traffic will be forwarded to your ingress controller, allowing you to manage certificates using your ingress controller, for example.

helm install --set controller.service.appProtocol=false ingress-nginx ingress-nginx/ingress-nginx

For our demo we will use a public and free DNS service called nip.io. It will help and simplify our demo regarding the DNS resolution, but it is not mandatory at all, you can rely on your classical DNS resolution system.

nip.io will resolve the names by answering the IP provided in the name.
Example for :

banana.100.10.12.2.nip.ip will return the ip : 100.100.12.2

apple.100.10.12.2.nip.ip will return the ip : 100.100.12.2

cat <<EOF | kubectl create -f -
kind: Pod
apiVersion: v1
metadata:
  name: apple-app
  labels:
    app: apple
spec:
  containers:
    - name: apple-app
      image: hashicorp/http-echo
      args:
        - "-text=apple"

---

kind: Service
apiVersion: v1
metadata:
  name: apple-service
spec:
  selector:
    app: apple
  ports:
    - port: 5678 # Default port for image
EOF

cat <<EOF | kubectl create -f -
kind: Pod
apiVersion: v1
metadata:
  name: banana-app
  labels:
    app: banana
spec:
  containers:
    - name: banana-app
      image: hashicorp/http-echo
      args:
        - "-text=banana"

---

kind: Service
apiVersion: v1
metadata:
  name: banana-service
spec:
  selector:
    app: banana
  ports:
    - port: 5678 # Default port for image
EOF

kubectl get pods banana
kubectl get pods apple

if you just installed Nginx ingress Controller recently the EXTERNAL-IP address can take some minutes to be affected to your Load Balancer. You can control in vCloud Director that you have enough Virtual Service available in your Edge Gateway

kubectl get svc ingress-nginx-controller
NAME                       TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
ingress-nginx-controller   LoadBalancer   100.65.85.121   10.x.y.z    80:30536/TCP,443:32691/TCP   14m

cat <<EOF | kubectl create -f -
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: apple-ingress
  annotations:
    ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
  - host: apple.[ip].nip.io
    http:
      paths:
        - path: /
          pathType: Prefix
          backend:
            service:
              port: 
                number: 5678
              name: apple-service
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: banana-ingress
  annotations:
    ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
  - host: banana.[ip].nip.io
    http:
      paths:
        - path: /
          pathType: Prefix
          backend:
            service:
              port: 
                number: 5678
              name: banana-service
EOF

kubectl get ingress

cat <<EOF | kubectl create -f -
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: apple-ingress
  annotations:
    ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
  - host: apple.[ip].nip.io
    http:
      paths:
        - path: /
          pathType: Prefix
          backend:
            service:
              port: 
                number: 5678
              name: apple-service
---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: banana-ingress
  annotations:
    ingress.kubernetes.io/rewrite-target: /
spec:
  ingressClassName: nginx
  rules:
  - host: banana.[ip].nip.io
    http:
      paths:
        - path: /
          pathType: Prefix
          backend:
            service:
              port: 
                number: 5678
              name: banana-service
EOF