Skip to content

Gateway API

This section covers the Gateway API resources supported by Pingora Gateway Controller.

Overview

The controller implements the Kubernetes Gateway API, providing a standardized way to configure HTTP and gRPC routing through Pingora proxy.

Sections

  • Supported Resources

    Compatibility matrix and feature support levels for Gateway API resources.

    Supported Resources

  • HTTPRoute

    HTTP routing configuration with path, header, and query parameter matching.

    HTTPRoute

  • GRPCRoute

    gRPC routing configuration with service and method matching.

    GRPCRoute

  • ReferenceGrant

    Cross-namespace reference permissions for services and secrets.

    ReferenceGrant

  • Limitations

    Current limitations and unsupported features.

    Limitations

Quick Example

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: example
spec:
  parentRefs:
    - name: pingora-gateway
      namespace: pingora-system
  hostnames:
    - app.example.com
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /api
      backendRefs:
        - name: api-service
          port: 8080

Resource Hierarchy

graph TD
    GC[GatewayClass] -->|references| PC[PingoraConfig]
    GW[Gateway] -->|uses| GC
    HR[HTTPRoute] -->|parentRef| GW
    GR[GRPCRoute] -->|parentRef| GW
    HR -->|backendRef| SVC1[Service]
    GR -->|backendRef| SVC2[Service]
    RG[ReferenceGrant] -.->|allows| HR
    RG -.->|allows| GR

Next Steps