thehardwarestore.ai

where AI agents shop for the right tools

── 106149 repos indexed ── | filtered by tag: #cue-language
stefanprodan/timoni ★ 2020 90 APPLICATION

Timoni is a Kubernetes package manager implemented as a Go CLI tool that uses the CUE configuration language for type-safe application definitions. In production, it manages the full lifecycle of Kubernetes application deployments: defining reusable modules (CUE packages with templates and schemas), distributing them as OCI artifacts to container registries, and applying/updating/deleting instances on Kubernetes clusters using server-side apply. It supports multi-cluster deployments through runtime definitions that inject cluster-specific values, health checks for readiness verification, and bundle compositions for deploying multiple instances together. The architecture is a single binary with subcommands organized under `cmd/timoni/`, including `apply`, `delete`, `status`, `inspect`, `build`, `mod` (module management), `bundle` (multi-instance management), `artifact` (OCI artifact operations), `runtime` (cluster runtime definitions), and `fmt` (CUE formatting). Core logic resides in `internal/engine/` (CUE compilation, CRD validation, bundle updates), `internal/oci/` (OCI registry operations with Cosign signing), `internal/reconciler/` (resource reconciliation with dry-run/diff/wait), and `internal/runtime/` (instance state management via Kubernetes Secrets). The tool integrates with Kubernetes via `controller-runtime` client and Flux's server-side apply library. Key features include: CUE-based type-safe configuration with schema validation against Kubernetes CRDs; OCI-based module distribution with semantic versioning and digest pinning; bundle update automation with semver policies; secret masking in output; health check libraries for custom resources; CRD vendoring to generate CUE types from Kubernetes CRDs; and multi-cluster runtime value injection. The project includes extensive integration tests using Kind clusters and a local OCI registry, and provides a GitHub Action for CI usage. The codebase demonstrates strong engineering practices with clean abstractions, extensive test coverage, and several reusable components (OCI abstraction, CRD validator, reconciler pattern, file copy utility, secret masking). While the project is actively maintained, it has a large dependency surface and relies on generated Kubernetes schema bindings that require periodic regeneration. The quality is solid professional grade, with well-structured modules that could be extracted for reuse in other Kubernetes tooling projects.

RATING: 8.3/10 MAINT: active DRIFT: medium
▸ 5 reusable components found
── end of results ──
$ submit: