Gloo Gateway is a cloud-native Layer 7 proxy that is based on the Kubernetes Gateway API.

Set up Gloo Gateway v2

You can deploy Gloo Gateway v2 by using the glooctl or helm command line tools.

Deploy a sample app

  1. Create the httpbin namespace.

      kubectl create ns httpbin
  2. Deploy the httpbin app.

      kubectl -n httpbin apply -f
  3. Verify that the httpbin app is running.

      kubectl -n httpbin get pods

    Example output:

      NAME                      READY   STATUS    RESTARTS   AGE
    httpbin-d57c95548-nz98t   3/3     Running   0          18s

Expose the app on the gateway

  1. Create an HTTPRoute resource to expose the httpbin app on the gateway. The following example exposes the app on the domain.

      kubectl apply -f- <<EOF
    kind: HTTPRoute
      name: httpbin
      namespace: httpbin
        example: httpbin-route
        - name: http
          namespace: gloo-system
        - ""
        - backendRefs:
            - name: httpbin
              port: 8000
    spec.parentRefsThe name and namespace of the gateway resource that serves the route. In this example, you use the HTTP gateway that you created earlier.
    spec.hostnamesA list of hostnames that the route is exposed on.
    spec.rules.backendRefsThe Kubernetes service that serves the incoming request. In this example, requests to are forwarded to the httpbin app on port 9000. Note that you must create the HTTP route in the same namespace as the service that serves that route. To create the HTTP route resource in a different namespace, you must create a ReferenceGrant resource to allow the HTTP route to forward requests to a service in a different namespace. For more information, see the Kubernetes API Gateway documentation.
  2. Verify that the HTTPRoute is applied successfully.

      kubectl get -n httpbin httproute/httpbin -o yaml
  3. Send a request to the httpbin app.

Next steps

Now that you have Gloo Gateway v2 set up and running, check out the following guides to expand your API gateway capabilities.


If you no longer need this quick-start Gloo Gateway v2 environment, you can uninstall your setup by following the steps in the Uninstall guide.