local-development-guide.md

Local Development Guide

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.