Test cluster using kind

This repo contains configuration files for setting up a test cluster on kind. See the 2nd-level README.md files for information about each service.

Note

Terminology: We will use "service" (lowercase) to refer to a logical unit in our cluster, and Service (uppercase) to refer specifically to the Kubernetes resource type.

• To launch the cluster: execute

  ./init.sh

  This installs the base services only: the Kubernetes dashboard, Traefik, and a simple whoami service.
• To expose Traefik, execute

  ./traefik/portforward.sh

• To expose the Kubernetes dashboard, execute

  ./dashboard/portforward.sh

• To launch service foo: execute

  ./foo/init.sh

  In general, each service will have an init.sh and delete.sh script, and possibly a portforward.sh script.

Warning

Some services will require additional setup before installation, for example the management of secrets. In general, a *secrets.example* file will be provided for templating.

Port forwarding and SSH tunneling

Our port-forwarding scripts are set up to forward to localhost only. To access the Traefik endpoint remotely, use:

ssh -L 8000:localhost:8000 <user>@<hostname>

The endpoint should then be available at http://<hostname>:8000. Similarly, create tunnels on the other forwarded ports to access the Traefik and Kubernetes dashboards.