Host and path

Learn host and path-based routing.

Host and path

A single Ingress can route by both domain name and path. pathType is the matching style:

Prefix: /api matches /api and /api/urunler (by path segment).
Exact: only exactly /api.

If several paths match, the longest prefix wins.

  rules:
    - host: magaza.example.com
      http:
        paths:
          - path: /api
            pathType: Prefix
            backend: {service: {name: api, port: {number: 8000}}}
          - path: /
            pathType: Prefix
            backend: {service: {name: web, port: {number: 80}}}
    - host: panel.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend: {service: {name: panel, port: {number: 80}}}

Trying it locally

To test without a real DNS record, the request is sent to the controller's IP and the domain name is given with the Host header; or a line is added to /etc/hosts:

curl -H "Host: magaza.example.com" http://$(minikube ip)/api/saglik
echo "$(minikube ip) magaza.example.com panel.example.com" | sudo tee -a /etc/hosts
curl http://panel.example.com/

Exercise A two-path Ingress

Write an Ingress's rules section (starting with rules:): host magaza.example.com; /api (Prefix) goes to port 8000 of the api service, / (Prefix) to port 80 of the web service.

Show example solution

rules:
  - host: magaza.example.com
    http:
      paths:
        - path: /api
          pathType: Prefix
          backend:
            service:
              name: api
              port:
                number: 8000
        - path: /
          pathType: Prefix
          backend:
            service:
              name: web
              port:
                number: 80

Test yourself

With the rules above, where does a request to magaza.example.com/api/urunler go?
- api:8000
- web:80
- panel:80
- 404
Show answer

api:8000 — /api wins because it's longer than the / prefix.

Match only the exact path.

          - path: /saglik
            pathType: ____

Show answer

          - path: /saglik
            pathType: Exact

Match.

Prefix

Path segment prefix
Exact

Exact match
longest prefix

Wins on overlap
Host header

Testing without DNS

Next lesson: TLS termination

We Are Enhancing Your Experience

Cookie Preferences

Strictly Necessary Cookies

Analytical Cookies