Skip to content

Example of how to use Kubernetes Gateway API in a local Kind cluster (via podman) using Project Contour https://projectcontour.io/

License

Notifications You must be signed in to change notification settings

domeales-paloit/kind-podman-gateway-api-contour

Repository files navigation

Gateway API via Contour on Kind via Podman

This is an example of how to run the Project Contour implementation of the Kubernetes Gateway API on a local Kind cluster using Podman for containers.

There are more likely other ways to achieve ingress into a Kind cluster using the Gateway API, this is just the one I came up with.

Why?

I did this as a learning exercise to understand the Gateway API but I also learnt how Kind does networking and lots about Contour.

Why Contour? To be honest I tried a number of Gateway API implementations and this is the only one I got working.

Dependencies

The following tools are needed to run this project:

Versions used at time of authoring:

  • podman 5.1.1
  • kind 0.23.0
  • kubectl v1.30.2
  • curl 8.6.0

Network design

For this project I selected the "Service with NodePort" networking strategy to get traffic into the Kind cluster. More information about this can be found in the repo domeales-paloit/kind-traffic-ingress-examples.

How to run

Inspect the contents of each Bash script and then run them in order:

  1. ./01-start-cluster.sh
  2. ./02-install-contour-api-gateway.sh
  3. ./03-deploy-httpbin.sh
  4. ./04-add-route-to-httpbin.sh

Great, you're all set up!

Now test that you have connectivity to the httpbin Pods by running curl:

curl -v http://localhost:32201/get

And you should see the output from httpbin. There are plenty of options with httpbin, check out the docs here: httpbin.org.

Congratulations, you have just deployed Gateway API on a Kind cluster via Podman.

Clean up!

Important! When finished testing, delete the cluster

./99-delete-cluster.sh

About

Example of how to use Kubernetes Gateway API in a local Kind cluster (via podman) using Project Contour https://projectcontour.io/

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages