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

1. Install the httpbin app.

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

2. Verify that the httpbin app is up and running.

   kubectl get pods -n httpbin

3. 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

4. Send a request to the httpbin app.

   Cloud Provider LoadBalancerPort-forward for local testing

   1. 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 agentgateway-proxy -o=jsonpath="{.status.loadBalancer.ingress[0]['hostname','ip']}")
      echo $INGRESS_GW_ADDRESS

   2. 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"

      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"
         ]
       }
      }

   1. Port-forward the gateway proxy agentgateway-proxy pod on port 8080.

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

   2. 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"
          ]
        }
      }