Ingress YAML

Learn the Ingress resource YAML structure.

Ingress YAML

Ingress rules are listed under rules; each rule contains a host and a list of paths. Each path goes to a backend service:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: magaza
spec:
  ingressClassName: nginx
  rules:
    - host: magaza.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web
                port:
                  number: 80

The default backend

Requests matching no rule go to the defaultBackend; if it isn't defined, the controller returns 404. A rule with no host accepts all domain names:

spec:
  ingressClassName: nginx
  defaultBackend:
    service:
      name: bulunamadi
      port:
        number: 80
  rules:
    - http:                # no host: all names
        paths:
          - path: /
            pathType: Prefix
            backend:
              service: {name: web, port: {number: 80}}

Exercise Write an Ingress

Write an Ingress YAML: name magaza; ingressClassName: nginx; host magaza.example.com; the / path (pathType: Prefix) goes to port 80 of the web service.

Show example solution

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: magaza
spec:
  ingressClassName: nginx
  rules:
    - host: magaza.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: web
                port:
                  number: 80

Test yourself

What is the Ingress's apiVersion?
- extensions/v1beta1
- networking.k8s.io/v1
- v1
- apps/v1
Show answer

networking.k8s.io/v1 — extensions/v1beta1 is the old, removed version.

Give the backend service's port.

            backend:
              service:
                name: web
                port:
                  ____: 80

Show answer

            backend:
              service:
                name: web
                port:
                  number: 80

Match.

rules

Rule list
host

Domain name
backend.service

Target service
defaultBackend

Unmatched requests

Next lesson: Host and path

We Are Enhancing Your Experience

Cookie Preferences

Strictly Necessary Cookies

Analytical Cookies