Skip to content
Kubernetes

Testing & Validation

The Kubernetes lexicon includes scripts to verify the full import–serialize roundtrip and validate serialized YAML against a real cluster.

Roundtrip tests

Section titled “Roundtrip tests”

The roundtrip test suite clones kubernetes/examples and runs each manifest through the full pipeline:

Input YAML → parse → generate TS → dynamic import → serialize YAML → re-parse → compare

“Pass” means the serialized YAML, when re-parsed, produces the same number of resources with matching kind values. Exact YAML comparison is intentionally skipped — key ordering, quoting, and comments differ between input and output.

Running

Section titled “Running”
Terminal window
cd lexicons/k8s


# Full roundtrip (clones repo on first run)
just full-roundtrip


# Skip clone if repo is already cached
just full-roundtrip --skip-clone


# Parse + generate only (skip serialize phase)
just full-roundtrip --skip-clone --skip-serialize


# Verbose output + filter to a specific manifest
just full-roundtrip --skip-clone --verbose --manifest guestbook

The test requires just generate to have been run first so the generated index exports real constructors. If the generated index is empty, the test falls back to parse-only mode automatically.

Parse-only roundtrip

Section titled “Parse-only roundtrip”

The original parse-only roundtrip test is still available:

Terminal window
just import-samples --skip-clone --verbose

k3d cluster validation

Section titled “k3d cluster validation”

The k3d validation script applies serialized YAML to a real Kubernetes cluster to verify the output is valid and deployable.

Prerequisites

Section titled “Prerequisites”
  • k3d — lightweight K8s cluster in Docker
  • kubectl — Kubernetes CLI
  • Docker running

Running

Section titled “Running”
Terminal window
cd lexicons/k8s


# Create cluster, run tests, delete cluster
just k3d-validate


# Keep cluster for manual inspection
just k3d-validate --keep-cluster


# Reuse an existing cluster
just k3d-validate --reuse-cluster --verbose

After --keep-cluster, inspect resources manually:

Terminal window
kubectl get all
kubectl get deployments,services

Safe manifest allowlist

Section titled “Safe manifest allowlist”

The script uses a curated allowlist of ~14 manifests known to work on bare k3d (no cloud volumes, CRDs, or GPUs). These include:

  • Guestbook — Deployments and Services for frontend + Redis
  • Cassandra — Headless Service
  • vLLM — Service

What it validates

Section titled “What it validates”

For each manifest the script:

  1. Runs the full roundtrip (YAML → Chant DSL → YAML)
  2. Applies the serialized YAML with kubectl apply
  3. Verifies the resource exists with kubectl get

A failure at any stage is reported with the specific phase that failed.

See also

Section titled “See also”