How gustavfredrikson/cka-dojo works
cka-dojo is a CLI for CKA practice on disposable, local Kubernetes clusters. A learner selects an exercise, the lab engine prepares its scenario, and the learner works in the cluster before grading checks the resulting state. The product also provides ordered lessons and prerequisites, hints and solutions, environment lifecycle commands, progress tracking, recommendations, and readiness assessment. The graph follows documented workflows and sampled wiring; some subsystem links are omitted where the excerpts do not establish the caller.
Main entry points: lab.go Lab Commands · manager.go Environment Manager · app.go Command Wiring · progress.go Study History
Components 20
Learning Content
- Curriculum
internal/curriculum/curriculum.go - Learning Path
internal/learning/path.go
Lab Practice
- Lab Definitions
internal/lab/lab.go - Scenario Runner
internal/lab/runner.go - Fault Injection
internal/fault/fault.go - State Grading
internal/grader/grader.go
Cluster Environment
- Environment Manager
internal/environment/manager.go - Provisioning
internal/environment/provision.go - Environment Profiles
internal/environment/profile.go - Lima Provider
internal/provider/lima/lima.go - Exam Scrub
internal/environment/scrub.go
Study Tracking
- Study History
internal/progress/progress.go - Recommendations
internal/recommend/recommend.go - Readiness Assessment
internal/readiness/readiness.go
CLI Runtime
- CLI Entry
cmd/dojo/main.go - Command Wiring
internal/cli/app.go - Lab Commands
internal/cli/lab.go - Environment Commands
internal/cli/env.go - Learning Commands
internal/cli/learn.go
Other components
- Learner
Connections 26
- Learner → CLI Entry: runs commands
- CLI Entry → Command Wiring: dispatches to
cmd/dojo/main.go - Command Wiring → Lab Commands: wires commands
internal/cli/app.go - Command Wiring → Environment Commands: wires commands
internal/cli/app.go - Command Wiring → Learning Commands: wires commands
internal/cli/app.go - Lab Commands → Lab Definitions: selects lab
internal/cli/lab.go - Lab Commands → Scenario Runner: sets up scenario
- Scenario Runner → Fault Injection: applies faults
- Lab Commands → State Grading: checks cluster
- State Grading → Environment Manager: checks state through
internal/grader/grader.go - Lab Commands → Environment Manager: uses environment
internal/cli/lab.go - Environment Commands → Environment Manager: manages machines
internal/cli/env.go - Environment Manager → Provisioning: provisions nodes
- Environment Manager → Lima Provider: runs provider operations
- Provisioning → Environment Profiles: uses profile
- Lima Provider → Learner: provides VM shell
- Learning Commands → Curriculum: loads lessons
internal/cli/learn.go - Curriculum → Lab Definitions: loads labs
internal/curriculum/curriculum.go - Learning Commands → Learning Path: shows exercise path
internal/cli/learn.go - Lab Commands → Study History: records attempts
internal/cli/lab.go - Lab Commands → Recommendations: ranks practice
- Lab Commands → Readiness Assessment: assesses readiness
- Lab Commands → Exam Scrub: scrubs workspace
- Study History → Readiness Assessment: supplies history
internal/readiness/readiness.go - Study History → Recommendations: supplies history
internal/recommend/recommend.go - Lab Commands → Learner: shows task and hints