Skip to main content

Routes

Routes define how traffic flows from domains to backend services, supporting both HTTP and gRPC protocols through Kubernetes Gateway API resources.

Route Types

TypeResourceUse Case
HTTPHTTPRouteREST APIs, web applications
gRPCGRPCRoutegRPC services

Matching Rules

Routes match incoming requests using:

Match TypeHTTPgRPC
Path/api/v1/*N/A
MethodGET, POSTN/A
HeadersX-Version: v2X-Version: v2
Query Parameters?debug=trueN/A
Service/MethodN/Amyservice/MyMethod

Backend Configuration

Each route specifies one or more backends:

backends:
- name: api-service
namespace: production
port: 8080
weight: 100

Approval Workflow

Routes follow a controlled deployment process:

┌────────┐     ┌─────────┐     ┌──────────┐
│ Submit │ ──▶ │ Approve │ ──▶ │ Deploy │
└────────┘ └─────────┘ └──────────┘
StatusDescription
PendingAwaiting approval
ApprovedReady for deployment
DeployedActive in Kubernetes
RejectedApproval denied

Traffic Features

Routes support advanced traffic management:

  • Timeouts: Request and backend timeouts
  • Retries: Automatic retry with backoff
  • Rate Limiting: Request throttling
  • Circuit Breaker: Failure protection