Local Development Guide
June 15, 2026 ยท View on GitHub
This guide explains how to test local code changes in your kind cluster.
Helm Chart
Note: If you want to use a local chart, you need a local installation of helmfile. Otherwise a container will be used and the chart will not be visible.
1. Get Local Charts
The charts are published from cf-k8s-releases. Just clone this repository.
2. Use local Chart
Edit the versions.yaml and change the release you want to consume from the published chart to the local path.
Example:
To consume a local diego chart:
```yaml
charts:
diego:
url: ../cf-k8s-releases/diego/helm # path to the chart
version: 1.238.0 # is not used in local case, just keep it
Docker Image
1. Build Local Image
The images are built in cf-k8s-releases. For building the image with modified source code, please refer to th local-development-guide.
2. Load Image into kind
Make the locally built image available to your kind cluster:
kind load docker-image <image>:latest --name cfk8s
Example:
kind load docker-image gorouter:latest --name cfk8s
3. Use the Image
Update the deployment or daemonset to use your local image:
kubectl edit deployment <component-name>
Example:
kubectl edit deployment gorouter
Modify the image and pull policy:
spec:
template:
spec:
containers:
- name: gorouter
image: gorouter:latest
imagePullPolicy: IfNotPresent # Important: prevents pulling from registry
After save and exit the relevant pods will be restarted automatically.