Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Structure Comparison: Templates vs Extensions

Templates Structure (provisioning/workspace/templates/taskservs/)

taskservs/
├── container-runtime/
├── databases/
├── kubernetes/
├── networking/
└── storage/

Extensions Structure (provisioning/extensions/taskservs/)

taskservs/
├── container-runtime/     (6 taskservs: containerd, crio, crun, podman, runc, youki)
├── databases/             (2 taskservs: postgres, redis)
├── development/           (6 taskservs: coder, desktop, gitea, nushell, oras, radicle)
├── infrastructure/        (6 taskservs: kms, kubectl, os, polkadot, provisioning, webhook)
├── kubernetes/            (1 taskserv: kubernetes + submodules)
├── misc/                  (1 taskserv: generate)
├── networking/            (6 taskservs: cilium, coredns, etcd, ip-aliases, proxy, resolv)
├── storage/               (4 taskservs: external-nfs, mayastor, oci-reg, rook-ceph)
├── info.md               (metadata)
├── kcl.mod               (module definition)
├── kcl.mod.lock          (lock file)
├── README.md             (documentation)
├── REFERENCE.md          (reference)
└── version.k             (version info)

🎯 Perfect Match for Core Categories

Matching Categories (5/5)

  • container-runtime/ - MATCHES
  • databases/ - MATCHES
  • kubernetes/ - MATCHES
  • networking/ - MATCHES
  • storage/ - MATCHES

📈 Extensions Has Additional Categories (3 extra)

  • development/ - Development tools (coder, desktop, gitea, etc.)
  • infrastructure/ - Infrastructure utilities (kms, kubectl, os, etc.)
  • misc/ - Miscellaneous (generate)

🚀 Result: Perfect Layered Architecture

The extensions now have the same folder structure as templates, plus additional categories for extended functionality. This creates a perfect layered system where:

  1. Layer 1 (Core): provisioning/extensions/taskservs/{category}/{name}
  2. Layer 2 (Templates): provisioning/workspace/templates/taskservs/{category}/{name}
  3. Layer 3 (Infrastructure): workspace/infra/{name}/task-servs/{name}.k

Benefits Achieved:

  • Consistent Navigation - Same folder structure
  • Logical Grouping - Related taskservs together
  • Scalable - Easy to add new categories
  • Layer Resolution - Clear precedence order
  • Template System - Perfect alignment for reuse

📊 Statistics

  • Total Taskservs: 32 (organized into 8 categories)
  • Core Categories: 5 (match templates exactly)
  • Extended Categories: 3 (development, infrastructure, misc)
  • Metadata Files: 6 (kept in root for easy access)

The reorganization is complete and successful! 🎉