Get started

Install Solo Enterprise for kgateway, deploy a sample app, and verify traffic routing.

Get started with Solo Enterprise for kgateway. Solo Enterprise for kgateway 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 Solo Enterprise for kgateway 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 Solo Enterprise for kgateway CRDs by using Helm. The following command uses the latest stable release, 2.1.5. For active development, update the version to 2.2.0-main.
```
helm upgrade -i enterprise-kgateway-crds oci://us-docker.pkg.dev/solo-public/enterprise-kgateway/charts/enterprise-kgateway-crds \
  --create-namespace \
  --namespace kgateway-system \
  --version 2.1.5 
```
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 Solo Enterprise for kgateway by using Helm.

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

Make sure that the enterprise-kgateway control plane is running.

kubectl get pods -n kgateway-system

Example output:

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

Good job! You now have the Solo Enterprise for kgateway control plane running in your cluster.

Next steps

Set up an API gateway with an httpbin sample app. This guide uses the Envoy-based Solo Enterprise for kgateway 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 Solo Enterprise for kgateway? Uninstall with the following command:

helm uninstall enterprise-kgateway -n kgateway-system

About