You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
homepage/k3d/README.md

2.0 KiB

Kubernetes Development

These configs and scripts attempt to simplify spinning up a kubernetes cluster for development and testing purposes. It leverages k3d to create a k3s cluster in Docker. Homepage can then be deployed either via the k3d-deploy.sh script, or tilt can be used to spin up a local CI loop that will automatically update the deployment.

All the commands in the document should be run from the k3d directory.

Requisite Tools

Tool Description
docker Docker container runtime
kubectl Kubernetes CLI
helm Kubernetes package manager
k3d Kubernetes on Docker - used to create the cluster
k9s (Optional) Command line view for kubernetes cluster
tilt (Optional) Local CI loop for kubernetes deployment
direnv (Optional) Automatically loads kubeconfig via .envrc

One-off Test Deployments

Create a cluster:

./k3d-up.sh

Build and deploy:

./k3d-deploy.sh

Open the Homepage deployment:

xdg-open http://homepage.k3d.localhost:8080/

Continuous Deployment

Create a cluster:

./k3d-up.sh

Kick off tilt:

tilt up

Press space bar to open the tilt web UI, which is quite informative.

Finally, open the Homepage deployment:

xdg-open http://homepage.k3d.localhost:8080/