What is Ingress Builder?

Ingresses are Kubernetes resources used to direct HTTP and HTTPS traffic to your cluster services. In order to correctly use an ingress resource a dedicated ingress-controller must be present and running in the host cluster.

Ingress Builder allows users to select any annotation from the list of available controllers, to add to the ingress manifest.

All thoughts and comments on Ingress Builder are welcomed! Let us know by tweeting at @JetstackHQ.

Was officially deprecated in Kubernetes v1.14.+, unavailable in v1.22+. Use Networking.k8s.io/v1 instead.

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    $YOUR_ANNOTATIONS
spec:
  rules:
  - host: $YOUR_HOST
    http:
      paths:
        - path: $YOUR_PATH
          backend:
            serviceName: $YOUR_SERVICE
            servicePort: $YOUR_SERVICE_PORT
  tls:
  - hosts:
      - $YOUR_HOST
    secretName: $YOUR_TLS_SECRET

Deprecated in Kubernetes v1.19.0. Use networking.k8s.io/v1 instead.

apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    $YOUR_ANNOTATIONS
spec:
  rules:
  - host: $YOUR_HOST
    http:
      paths:
        - path: $YOUR_PATH
          backend:
            serviceName: $YOUR_SERVICE
            servicePort: $YOUR_SERVICE_PORT
  tls:
  - hosts:
      - $YOUR_HOST
    secretName: $YOUR_TLS_SECRET

This ingress version is only supported in Kubernetes v1.19.0 and up.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: example-ingress
  annotations:
    $YOUR_ANNOTATIONS
spec:
  rules:
  - host: $YOUR_HOST
    http:
      paths:
      - path: $YOUR_PATH
        pathType: Prefix
        backend:
          service:
            name: $YOUR_SERVICE
            port:
              number: $YOUR_SERVICE_PORT
  tls:
  - hosts:
      - $YOUR_HOST
    secretName: $YOUR_TLS_SECRET