Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions content/docs/deploy/k8s/ingress.md
Original file line number Diff line number Diff line change
Expand Up @@ -148,6 +148,7 @@ The expandable list below contains the annotations available, which behave as de
- [`ingress.pomerium.io/host_rewrite`]
- [`ingress.pomerium.io/host_rewrite_header`]
- [`ingress.pomerium.io/idle_timeout`]
- [`ingress.pomerium.io/name`]
- [`ingress.pomerium.io/mcp_client`]
- [`ingress.pomerium.io/mcp_server`]
- [`ingress.pomerium.io/mcp_server_max_request_bytes`]
Expand Down Expand Up @@ -275,6 +276,43 @@ If you have Ingresses with potentially overlapping host/path combinations, Pomer

This sorting order helps ensure that more restrictive routes for specific paths and regular expressions are applied correctly.

### Route Naming

By default, Pomerium generates route names based on the Ingress namespace, name, and host. You can customize the human-readable route name using the `name` annotation:

```yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: my-app
namespace: production
annotations:
ingress.pomerium.io/name: 'Production App'
ingress.pomerium.io/policy: |
allow:
and:
- domain:
is: company.com
spec:
ingressClassName: pomerium
rules:
- host: app.company.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: my-app-service
port:
number: 80
```

In this example:

- The route will display as "Production App" in Pomerium's UI and logs
- The unique identifier for monitoring and stats remains based on the Ingress resource details

### Regular Expressions Path Matching

You can use a [re2 regular expression] to create an Ingress that matches multiple paths.
Expand Down
Loading