---

name: local-development description: >- Set up a local development environment for tekton-pruner. Use when onboarding, bootstrapping a kind cluster, deploying the operator locally, or iterating on controller and webhook changes. Covers kind, ko, Tekton Pipelines, and the observability stack (Prometheus + Jaeger). license: Apache-2.0 compatibility: Requires go, kind, ko, kubectl, docker (or podman) metadata: project: tekton-pruner maintainers: tektoncd allowed-tools: Bash(kind:) Bash(ko:) Bash(kubectl:) Bash(docker:) Bash(make:*) Read

Local Development

tekton-pruner is a Kubernetes controller and admission webhook that prunes Tekton PipelineRun and TaskRun resources based on TTL or history limits configured via a ConfigMap or per-namespace annotations.

Prerequisites

Install the following tools before proceeding:

| Tool | Purpose | |------|---------| | go (≥ 1.26) | Build language | | kind | Local Kubernetes cluster | | ko | Build and push Go container images | | kubectl | Interact with the cluster | | docker or podman | Container runtime (podman sets CONTAINER_RUNTIME=podman) |

Quick-Start: Full Cluster Setup

The recommended path for a fresh local environment:

cd hack/dev/kind/
./install.sh

This script:

1. Starts a local container registry on port 5000 (kind-registry)
2. Creates a kind cluster named kind (override with KIND_CLUSTER_NAME)
3. Wires the cluster to the registry
4. Sets KUBECONFIG to ~/.kube/config.kind
5. Deploys Tekton Pipelines and the pruner controller via ko apply

After it completes, verify:

export KUBECONFIG=~/.kube/config.kind
kubectl get pods -n tekton-pipelines

Deploy Only the Pruner

If you already have a cluster with Tekton Pipelines running:

export KO_DOCKER_REPO=<your-registry>   # e.g. ko.local or localhost:5000
ko apply -f config/

To redeploy individual components after code changes:

# Controller only
ko apply -f config/controller.yaml

# Webhook only
ko apply -f config/webhook.yaml

Observability Stack (Optional)

For metrics and tracing during development:

./hack/setup-observability-dev.sh

Endpoints after setup:

| Service | URL | |---------|-----| | Prometheus | http://localhost:9091 | | Jaeger (tracing) | http://localhost:16686 | | Pruner metrics | http://localhost:9090/metrics |

Iterating on Code

1. Edit Go source under pkg/ or cmd/.
2. Run unit tests to verify: make test-unit
3. Format code: make fmt
4. Rebuild and redeploy (ensure KO_DOCKER_REPO is set — see "Deploy Only the Pruner" above): ko apply -f config/controller.yaml
5. Check controller logs:

kubectl -n tekton-pipelines logs deployment/tekton-pruner-controller -f

Tear Down

ko delete -f config/
# or to destroy the entire kind cluster:
kind delete cluster --name kind

Environment Variables

| Variable | Default | Purpose | |----------|---------|---------| | KO_DOCKER_REPO | (required) | Image registry for ko builds | | KIND_CLUSTER_NAME | kind | Name of the kind cluster | | CONTAINER_RUNTIME | docker | Set to podman for rootless builds |

Common Issues

• ko not found: Run make apply — it auto-installs ko into .bin/.
• Registry not reachable: Ensure kind-registry container is running: docker ps | grep kind-registry
• Webhook TLS errors: The webhook cert is managed by the operator. If invalid, delete the Secret and restart the webhook pod.