How yannh/kubeconform works
Kubeconform validates Kubernetes manifests from files, directories, or stdin against configurable local or remote JSON schemas, then reports each resource’s result. The CLI configures discovery, runs validation concurrently, and selects a result format. Validation parses resource identity, applies skip/reject and strictness options, retrieves and caches schemas, and checks manifests against them. The README also documents custom schema locations, missing-schema handling, and JSON, JUnit, pretty, TAP, and text output. Source excerpts show the primary runtime wiring; unsampled resource and registry internals limit some relationship detail.
Main entry points: main.go Kubeconform CLI · registry.go Schema registries · resource Resource discovery · validator.go Resource validator
Components 16
CLI and configuration
- Kubeconform CLI
cmd/kubeconform/main.go - Flag configuration
pkg/config/config.go
Manifest inputs
- Resource discovery
pkg/resource - Stream parsing
pkg/resource/stream.go - File discovery
pkg/resource/files.go
Schema validation
- Resource validator
pkg/validator/validator.go - Schema registries
pkg/registry/registry.go - HTTP registry
pkg/registry/http.go - Local registry
pkg/registry/local.go - HTTP schema loader
pkg/loader/http.go - File schema loader
pkg/loader/file.go - Schema cache
pkg/cache
Results and reporting
- Output selection
pkg/output/output.go - Result formatters
pkg/output
Other components
- CLI user
- Schema source
Connections 20
- CLI user → Kubeconform CLI: invokes
Readme.md - Kubeconform CLI → Flag configuration: parses flags
cmd/kubeconform/main.go - Kubeconform CLI → Output selection: selects format
cmd/kubeconform/main.go - Kubeconform CLI → Resource validator: creates and calls
cmd/kubeconform/main.go - Kubeconform CLI → Resource discovery: discovers resources
cmd/kubeconform/main.go - Resource discovery → Stream parsing: reads stdin
- Resource discovery → File discovery: scans files
- Resource validator → Resource discovery: parses streams
pkg/validator/validator.go - Resource validator → Schema registries: requests schemas
pkg/validator/validator.go - Schema registries → HTTP registry: creates HTTP registry
pkg/registry/registry.go - Schema registries → Local registry: creates local registry
pkg/registry/registry.go - Schema registries → HTTP schema loader: configures HTTP loading
pkg/registry/registry.go - Schema registries → File schema loader: configures file loading
pkg/registry/registry.go - HTTP schema loader → Schema cache: reads and writes
pkg/loader/http.go - Schema registries → Schema cache: configures disk cache
pkg/registry/registry.go - HTTP schema loader → Schema source: fetches schema
pkg/loader/http.go - File schema loader → Schema source: loads local schema
- Kubeconform CLI → Result formatters: writes results
cmd/kubeconform/main.go - Output selection → Result formatters: constructs formatter
pkg/output/output.go - Result formatters → Kubeconform CLI: accepts results
cmd/kubeconform/main.go