Get started

Get started with Gloo Gateway. Gloo Gateway is a control plane that implements the Kubernetes Gateway API for both microservices and AI workloads. The control plane translates your Kubernetes Gateway API resources into the configuration that the underlying data plane proxy can understand. The proxy layer is handled by kgateway’s implementation of Envoy for microservices workloads.

Before you begin

These quick start steps assume that you have a Kubernetes cluster, kubectl, and helm already set up. For quick testing, you can use Kind.

kind create cluster

Install

The following steps get you started with a basic installation. For detailed instructions, see the installation guides.

Set your Gloo Gateway license key as an environment variable. If you do not have one, contact an account representative.
```
export LICENSE_KEY=<license-key> 
```

Deploy the Kubernetes Gateway API CRDs.

kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.4.0/standard-install.yaml

Deploy the Gloo Gateway CRDs by using Helm. The following command uses the latest stable release, 2.0.2. For active development, update the version to 2.1.0-main2.1.0-main.
```
helm upgrade -i gloo-gateway-crds oci://us-docker.pkg.dev/solo-public/gloo-gateway/charts/gloo-gateway-crds \
  --create-namespace \
  --namespace gloo-system \
  --version 2.0.2 
```
If you already installed the external auth, rate limit, and Enterprise listener set CRDs, such as by previously installing another Solo product in the same cluster, include the –set installExtAuthCRDs=false and –set installRateLimitCRDs=false flags in the Helm installation.

Install Gloo Gateway by using Helm.

helm upgrade -i gloo-gateway oci://us-docker.pkg.dev/solo-public/gloo-gateway/charts/gloo-gateway \
  -n gloo-system \
  --version 2.0.2 \
  --set-string licensing.licenseKey=$LICENSE_KEY

Make sure that the gloo-gateway control plane is running.

kubectl get pods -n gloo-system

Example output:

NAME                            READY   STATUS    RESTARTS   AGE
gloo-gateway-5495d98459-46dpk   1/1     Running   0          19s

Good job! You now have the Gloo Gateway control plane running in your cluster.

Next steps

Set up an API gateway with an httpbin sample app. This guide uses the Envoy-based Gloo Gateway proxy to set up an API gateway. Then, deploy a sample httpbin app, configure a basic HTTP listener on the API gateway, and route traffic to httpbin by using an HTTPRoute resource.

Cleanup

No longer need Gloo Gateway? Uninstall with the following command:

helm uninstall gloo-gateway -n gloo-system

About