Sample app

You can set up the httpbin sample app. This app can be used to try out traffic management, security, and resiliency guides.

Before you begin

Set up an agentgateway proxy.

Install httpbin

Install the httpbin app.

kubectl apply -f https://raw.githubusercontent.com/kgateway-dev/kgateway/refs/heads/main/examples/httpbin.yaml

Verify that the httpbin app is up and running.
```
kubectl get pods -n httpbin
```

Create a route to the httpbin app.

kubectl apply -f- <<EOF
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: httpbin
  namespace: httpbin
spec:
  parentRefs:
    - name: agentgateway-proxy
      namespace: agentgateway-system
  hostnames:
    - "www.example.com"
  rules:
    - backendRefs:
        - name: httpbin
          port: 8000
EOF

Send a request to the httpbin app.

Get the external address of the gateway proxy and save it in an environment variable.

export INGRESS_GW_ADDRESS=$(kubectl get svc -n agentgateway-system agentgatway-proxy -o=jsonpath="{.status.loadBalancer.ingress[0]['hostname','ip']}")
echo $INGRESS_GW_ADDRESS

Send a request to the httpbin app and verify that you get back a 200 HTTP response code. Note that it might take a few seconds for the load balancer service to become fully ready and accept traffic.

curl -i http://$INGRESS_GW_ADDRESS:80/headers -H "host: www.example.com:8080"

Example output:

HTTP/1.1 200 OK
access-control-allow-credentials: true
access-control-allow-origin: *
content-type: application/json; encoding=utf-8
date: Thu, 13 Feb 2025 18:49:32 GMT
content-length: 330
x-envoy-upstream-service-time: 4
server: envoy

{
  "headers": {
    "Accept": [
      "*/*"
    ],
    "Host": [
      "www.example.com"
    ],
    "User-Agent": [
      "curl/8.7.1"
    ],
    "X-Envoy-Expected-Rq-Timeout-Ms": [
      "15000"
    ],
    "X-Forwarded-Proto": [
      "http"
    ],
    "X-Request-Id": [
      "26be0bcd-d941-48f4-ac3b-d5ac288ac46f"
    ]
  }
}

Port-forward the gateway proxy http pod on port 8080.

kubectl port-forward deployment/agentgateway-proxy -n agentgateway-system 8080:80

Send a request to the httpbin app and verify that you get back a 200 HTTP response code.

curl -i localhost:8080/headers -H "host: www.example.com"

Example output:

HTTP/1.1 200 OK
access-control-allow-credentials: true
access-control-allow-origin: *
content-type: application/json; encoding=utf-8
date: Thu, 13 Feb 2025 18:49:32 GMT
content-length: 330
x-envoy-upstream-service-time: 4
server: envoy

{
  "headers": {
    "Accept": [
      "*/*"
    ],
    "Host": [
      "www.example.com"
    ],
    "User-Agent": [
      "curl/8.7.1"
    ]
  }
}

Uninstall