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

Before you begin

  1. If you have not already, install helm, the Kubernetes package manager.

Install Gloo Gateway

Set up an API gateway

  1. Create a gateway resource and configure an HTTP listener. The following gateway can serve HTTP resources from all namespaces.

      kubectl apply -n gloo-system -f- <<EOF
    kind: Gateway
      name: http
      gatewayClassName: gloo-gateway
      - protocol: HTTP
        port: 8080
        name: http
            from: All
  2. Verify that the gateway is created successfully. You can also review the external address that is assigned to the gateway. Note that depending on your environment it might take a few minutes for the load balancer service to be assigned an external address.

      kubectl get gateway http -n gloo-system

    Example output:

      NAME   CLASS          ADDRESS                                                                  PROGRAMMED   AGE
    http   gloo-gateway   True         93s

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 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 environment, you can uninstall your setup by following the steps in the Uninstall guide.