Installing Gateway API for Knative¶
This page shows how to install the Kubernetes Gateway API. You can install either the standard or experimental Gateway API channel.
Before you begin¶
This installation requires the following prerequisites:
- A Kubernetes cluster with the Knative Serving component installed.
-
A Gateway Controller. You can install a Gateway Controller by using one of the following guides:
Some Gateway controller setups include the installation of the Gateway API.
Install the standard Gateway API channel¶
The standard release channel includes all resources that have graduated to general availability or beta, including GatewayClass, Kubernetes Gateway API, HTTPRoute, and ReferenceGrant.
Use the following command to install the standard channel:
kubectl apply --server-side -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.4.0/standard-install.yaml
For more information about the kubectl --server-side command, see Server-Side Apply.
Install the experimental Gateway API Channel¶
The experimental release channel includes everything in the standard release channel plus some experimental resources and fields. This includes TCPRoute, TLSRoute, and UDPRoute. Keep in mind that future releases of the API could introduce breaking changes as any experimental resource or field could be removed in a future release.
Use the following command to install the experimental channel:
kubectl apply --server-side -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.4.0/experimental-install.yaml
Refer to the server-side apply documentation to learn more about this kubectl command option.
Uninstall the Gateway API¶
To uninstall the Gateway API, replace kubectl apply --server-side -f with kubectl delete --server-side -f in the commands above.
Do not uninstall if the resources are in use or if they were installed by a Gateway controller. This command uninstalls the Gateway API resources for the entire cluster.