19c25713c4
Co-Authored-By: Ben Phelps <ben@phelps.io> |
||
|---|---|---|
| .. | ||
| .envrc | ||
| .gitignore | ||
| README.md | ||
| Tiltfile | ||
| k3d-deploy.sh | ||
| k3d-down.sh | ||
| k3d-helm-values.yaml | ||
| k3d-up.sh | ||
| k3d.yaml | ||
README.md
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/