people/docs/local_development_kube.md

Local development with Kubernetes

We use tilt to provide a local development environment for Kubernetes. Tilt is a tool that helps you develop applications for Kubernetes. It watches your files for changes, rebuilds your containers, and restarts your pods. It's like having a conversation with your cluster.

This is particularly useful when working on integrations or to test your helm charts. Otherwise, you can use your good old docker configuration as described in README.md.

Prerequisites

This guide assumes you have the following tools installed:

• Docker
• Kubectl
• Kind
  • mkcert
• ctlptl
• Tilt
  • helm
  • helmfile
  • secrets

Install_prereq script (not tested).

Helmfile in Docker

#!/bin/sh

docker run --rm --net=host \
   -v "${HOME}/.kube:/root/.kube" \
   -v "${HOME}/.config/helm:/root/.config/helm" \
   -v "${HOME}/.minikube:/${HOME}/.minikube" \
   -v "${PWD}:/wd" \
   -e KUBECONFIG=/root/.kube/config \
   --workdir /wd ghcr.io/helmfile/helmfile:v0.150.0 helmfile "$@"

Create the kubernetes cluster

Run the following command to create a kubernetes cluster using kind:

make start-kind

# import your secrets from credentials manager
# ! don't forget "https" before your url
make install-external-secrets

That's it! You should now have a local development environment for Kubernetes.

Start the application

# You can either start :
# ProConnect stack (but secrets must be set on your local cluster)
make tilt-up

# or standalone environment with keycloak
make start-tilt-keycloak

Access your application at https://desk.127.0.0.1.nip.io

Management

To manage the cluster, you can use k9s.

Next steps

• Add dimail to the local development environment
• Add a reset demo cmd_button to Tilt