Files
kandev/docs/plans/kubernetes-executor/task-01-backend-foundation.md
T
2026-09-02 13:50:03 +00:00

55 lines
3.0 KiB
Markdown

---
id: "01-backend-foundation"
title: "Kubernetes backend foundation"
status: completed
wave: 1
depends_on: []
plan: "plan.md"
spec: "../../specs/kubernetes-executor/spec.md"
---
# Task 01: Kubernetes backend foundation
- **Acceptance:** `k8s` is a registered remote/containerized runtime that never
falls back to standalone; typed executor/profile config supports kubeconfig
and in-cluster auth plus all three storage modes.
- **Acceptance:** strict PodTemplate merge preserves operator-owned fields and
rejects every Kandev-owned collision with stable field paths.
- **Acceptance:** Kubernetes clients, PVC synthesis, and exec/port-forward seams
are deterministic, redacted, and unit-testable without a real cluster.
- **Verification:** `cd apps/backend && go test ./internal/agentruntime ./internal/task/models ./internal/agent/kubernetes ./internal/backendapp`
- **Files likely touched:** `apps/backend/go.mod`, `apps/backend/go.sum`,
`internal/agentruntime/runtime.go`, `internal/agent/executor/executor.go`,
`internal/task/models/models.go`, `internal/agent/kubernetes/*.go`,
`internal/backendapp/agents.go`, and adjacent tests.
- **Dependencies:** None.
- **Parallelism:** sequential foundation; it owns the shared Go module files
and public runtime/config types.
- **Inputs:** spec What/Data model/Failure modes; ADR ownership split; Docker
and SSH registration/config patterns.
## Results
- Added the `k8s` remote/containerized runtime taxonomy, fail-closed lifecycle
registration seams, typed cluster/profile configuration, strict PodTemplate
validation and merge logic, managed-PVC synthesis, and injectable Kubernetes
client/exec/port-forward boundaries.
- TDD covered runtime classification, both authentication modes, all workspace
modes, strict YAML and reserved-field rejection, merge preservation, warning
generation, PVC validation, client loading/redaction, loopback-only
forwarding, and fail-closed registration.
- Integration review tightened that boundary further: mounts at or below
`/opt/kandev`, `/run/kandev`, and `/workspace` are reserved; managed-PVC
storage-class names receive Kubernetes DNS validation; and explicitly
enabled service-account token automount produces a stable warning. Composed
Pods now own both `spec.os.name: linux` and the Linux node selector, while
`HOME` plus all explicit `AGENTCTL_*` / `KANDEV_*` template env keys are
reserved for the managed bootstrap.
- `cd apps/backend && go test ./internal/agentruntime ./internal/task/models ./internal/agent/kubernetes ./internal/backendapp` passed.
- `cd apps/backend && go test ./internal/agent/executor` passed.
- `cd apps/backend && golangci-lint run ./internal/agentruntime ./internal/agent/executor ./internal/task/models ./internal/agent/kubernetes ./internal/backendapp --timeout=5m` passed with zero issues.
- `gofmt -l` over the changed Go files produced no output, and
`git diff --check` passed.
- Kubernetes modules are aligned at `v0.35.5`; only their required existing
dependency upgrades remain after `go mod tidy`.