Path-Based Routing with HTTPProxy

This guide shows how to configure path-based routing on a Datum AI Edge using an HTTPProxy resource. The example routes one exact path to a dedicated backend and sends all remaining traffic to a default backend.

Overview

Path-based routing lets you split traffic across backends based on the URL path, without changing your application or DNS. At a high level, this setup:

Defines an exact path match for a specific route (e.g., /login)
Adds a catch-all prefix rule for all other traffic
Applies both rules in a single HTTPProxy resource

Prerequisites

datumctl installed and authenticated
A valid Project

Verify access:

datumctl get httpproxy

Configuration Steps

Step 1: Set Variables

Windows (PowerShell)

$PROJECT    = "my-project"
$NAMESPACE  = "default"
$PROXY_NAME = "my-proxy"
$HOSTNAME   = "app.example.com"

macOS / Linux

PROJECT="my-project"
NAMESPACE="default"
PROXY_NAME="my-proxy"
HOSTNAME="app.example.com"

Step 2: Apply Path Routing Configuration

The /login path is matched exactly. All other requests fall through to the catch-all / rule. Place the exact match rule before the catch-all. Rules are evaluated in order, and a prefix of / matches everything.

Each rule currently supports only a single backend. Multiple backends per rule are not yet supported.

Windows (PowerShell)

@"
apiVersion: networking.datumapis.com/v1alpha
kind: HTTPProxy
metadata:
  name: $PROXY_NAME
spec:
  hostnames:
  - $HOSTNAME
  rules:
  - name: login-exact
    matches:
    - path:
        type: Exact
        value: /login
    backends:
    - endpoint: https://auth-origin.example

  - name: catch-all
    matches:
    - path:
        type: PathPrefix
        value: /
    backends:
    - endpoint: https://web-origin.example
"@ | datumctl apply --project $PROJECT --namespace $NAMESPACE -f -

macOS / Linux

cat <<EOF | datumctl apply --project $PROJECT --namespace $NAMESPACE -f -
apiVersion: networking.datumapis.com/v1alpha
kind: HTTPProxy
metadata:
  name: $PROXY_NAME
spec:
  hostnames:
  - $HOSTNAME
  rules:
  - name: login-exact
    matches:
    - path:
        type: Exact
        value: /login
    backends:
    - endpoint: https://auth-origin.example

  - name: catch-all
    matches:
    - path:
        type: PathPrefix
        value: /
    backends:
    - endpoint: https://web-origin.example
EOF

Verification

Exact Path Match

curl -v https://app.example.com/login

Expected: request reaches auth-origin.example.

Negative Test — Exact Is Truly Exact

curl -v https://app.example.com/login/reset

Expected: /login/reset does not match the Exact /login rule and falls through to the catch-all backend. Verify this to confirm the exact match boundary is working correctly.

Catch-All

curl -v https://app.example.com/

Expected: request reaches web-origin.example.

Cleanup

Windows (PowerShell)

datumctl delete httpproxy $PROXY_NAME `
  --project $PROJECT --namespace $NAMESPACE --ignore-not-found

macOS / Linux

datumctl delete httpproxy $PROXY_NAME \
  --project $PROJECT --namespace $NAMESPACE --ignore-not-found

Best Practices

Always include a PathPrefix / catch-all so no requests are dropped unexpectedly
Place more-specific rules (e.g., Exact, longer prefixes) before less-specific ones
Use distinct, descriptive rule name values — they appear in logs and aid debugging
Test both the matching path and a near-miss (e.g., /login/reset) to confirm exact boundaries

Summary

Path-based routing is configured using a HTTPProxy resource at networking.datumapis.com/v1alpha
Use type: Exact for single endpoints like /login
Use type: PathPrefix with value / as a catch-all for all remaining traffic
Rule order matters — place specific matches before the catch-all

Documentation

TLDR

Platform

AI Edge

Connectors

Galactic VPC

Domains & DNS

Agents

Tools

Path-Based Routing with HTTPProxy

Overview

Prerequisites

Configuration Steps

Step 1: Set Variables

Windows (PowerShell)

macOS / Linux

Step 2: Apply Path Routing Configuration

Windows (PowerShell)

macOS / Linux

Verification

Exact Path Match

Negative Test — Exact Is Truly Exact

Catch-All

Cleanup

Windows (PowerShell)

macOS / Linux

Best Practices

Summary

​Overview

​Prerequisites

​Configuration Steps

​Step 1: Set Variables

​Windows (PowerShell)

​macOS / Linux

​Step 2: Apply Path Routing Configuration

​Windows (PowerShell)

​macOS / Linux

​Verification

​Exact Path Match

​Negative Test — Exact Is Truly Exact

​Catch-All

​Cleanup

​Windows (PowerShell)

​macOS / Linux

​Best Practices

​Summary

Overview

Prerequisites

Configuration Steps

Step 1: Set Variables

Windows (PowerShell)

macOS / Linux

Step 2: Apply Path Routing Configuration

Windows (PowerShell)

macOS / Linux

Verification

Exact Path Match

Negative Test — Exact Is Truly Exact

Catch-All

Cleanup

Windows (PowerShell)

macOS / Linux

Best Practices

Summary