envtest-integration

name	envtest-integration
description	Setup, run, and debug Kubernetes integration tests using envtest. Use when working with test/integration or Kubernetes client behavior.

Envtest Integration Skill

When to use

• Changes in test/integration/
• Changes in Kubernetes client logic (internal/kube/)
• CRD-related changes
• Controller behavior affecting API interaction

---

Setup

Ensure envtest is installed:

setup-envtest use -p env 1.29.x

---

Run tests

task test:integration

or:

go test -tags=integration ./test/integration

---

Debugging checklist

• CRDs correctly loaded?
• API server started?
• Scheme registration correct?
• Resources created before assertions?
• Context timeouts correct?

---

Common issues

• Missing CRDs → ensure testdata paths correct
• Race conditions → check goroutines and async logic
• Timeouts → increase test context duration

---

Validation

task test
task test:integration

---

Output format

• What failed
• Root cause
• Fix suggestion
• Commands executed