You are browsing documentation for an older version. See the latest documentation here.

Create a Route

Note: Gateway and ControlPlane controllers are still alpha so be sure to use the installation steps from this guide in order to get your Gateway up and running.

After you’ve installed all of the required components and configured a GatewayClass you can route some traffic to a service in your Kubernetes cluster.

Configure the echo service

1. In order to route a request using Kong Gateway we need a service running in our cluster. Install an echo service using the following command:

    kubectl apply -f https://docs.konghq.com/assets/kubernetes-ingress-controller/examples/echo-service.yaml
   

2. Create a HTTPRoute to send any requests that start with /echo to the echo service.

   echo '
   kind: HTTPRoute
   apiVersion: gateway.networking.k8s.io/v1beta1
   metadata:
     name: echo
   spec:
     parentRefs:
       - group: gateway.networking.k8s.io
         kind: Gateway
         name: kong
     rules:
       - matches:
           - path:
               type: PathPrefix
               value: /echo
         backendRefs:
           - name: echo
             port: 1027
   ' | kubectl apply -f -
   

   The results should look like this:

   httproute.gateway.networking.k8s.io/echo created
   

Test the configuration

1. Run kubectl get gateway kong -n default to get the IP address for the gateway and set that as the value for the variable PROXY_IP.

    export PROXY_IP=$(kubectl get gateway kong -n default -o jsonpath='{.status.addresses[0].value}')
   

   Note: if your cluster can not provision LoadBalancer type Services then the IP you receive may only be routable from within the cluster.

2. Make a call to the $PROXY_IP that you configured.

    curl $PROXY_IP/echo
   

3. You should see the following:

    Welcome, you are connected to node king.
    Running on Pod echo-965f7cf84-rm7wq.
    In namespace default.
    With IP address 192.168.194.10.
   

   Congratulations! You just configured Kong Gateway Operator, Kong Ingress Controller and Kong Gateway using open standards.

Next steps

Now that you have a running DataPlane configured using Gateway API resources, you can explore the power that Kong Gateway provides:

• Configuring Kong Gateway plugins using Kong Ingress Controller
• Upgrading Kong Gateway Operator managed data planes