Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/stefanprodan/timoni

Timoni is a package manager for Kubernetes, powered by CUE and inspired by Helm.
https://github.com/stefanprodan/timoni

cuelang kubernetes package-manager

Last synced: 3 days ago
JSON representation

Timoni is a package manager for Kubernetes, powered by CUE and inspired by Helm.

Host: GitHub
URL: https://github.com/stefanprodan/timoni
Owner: stefanprodan
License: apache-2.0
Created: 2023-02-11T13:18:25.000Z (almost 2 years ago)
Default Branch: main
Last Pushed: 2024-10-28T10:53:44.000Z (3 months ago)
Last Synced: 2024-10-29T15:34:12.583Z (2 months ago)
Topics: cuelang, kubernetes, package-manager
Language: Go
Homepage: https://timoni.sh
Size: 3.05 MB
Stars: 1,544
Watchers: 23
Forks: 68
Open Issues: 42
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

awesome-repositories - stefanprodan/timoni - Timoni is a package manager for Kubernetes, powered by CUE and inspired by Helm. (Go)
awesome-cloud-native - timoni - Timoni is a package manager for Kubernetes, powered by CUE and inspired by Helm. (Application Delivery)

README

        # timoni

[![Sponsor this](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&link=https://github.com/sponsors/stefanprodan)](https://github.com/sponsors/stefanprodan)

[![release](https://img.shields.io/github/release/stefanprodan/timoni/all.svg)](https://github.com/stefanprodan/timoni/releases)

[![platforms](https://img.shields.io/badge/platforms-linux|macos|windows-9cf.svg)](https://timoni.sh/install)

[![build](https://github.com/stefanprodan/timoni/workflows/build/badge.svg)](https://github.com/stefanprodan/timoni/actions)

[![license](https://img.shields.io/github/license/stefanprodan/timoni.svg)](https://github.com/stefanprodan/timoni/blob/main/LICENSE)

[![SLSA 3](https://slsa.dev/images/gh-badge-level3.svg)](https://slsa.dev)

[Timoni](https://timoni.sh) is a package manager for Kubernetes,

powered by [CUE](https://cuelang.org/)

and inspired by [Helm](https://helm.sh/).

The Timoni project strives to improve the UX of authoring Kubernetes configs.

Instead of mingling Go templates with YAML like Helm,

or layering YAML on top of each-other like Kustomize,

Timoni relies on cuelang's type safety, code generation and data validation features

to offer a better experience of creating, packaging and delivering apps to Kubernetes.

> [!IMPORTANT]

> Note that Timoni in under active development and is still in its infancy.

> The APIs and command-line interface may change in a backwards incompatible manner.

## Get Started

To get started with Timoni please visit the documentation website at [timoni.sh](https://timoni.sh/quickstart/).

## Concepts

- [Module](https://timoni.sh/concepts/#module) - App definition containing Kubernetes CUE templates and configuration schema, distributed as OCI artifacts.

- [Instance](https://timoni.sh/concepts/#instance) - App instantiation referencing the module and workloads deployed on a Kubernetes cluster.

- [Bundle](https://timoni.sh/concepts/#bundle) - App composition bundling multiple modules and configurations into a deployable unit.

- [OCI Artifact](https://timoni.sh/concepts/#artifact) - Packaging format used for distributing modules and bundles to container registries.

> [!TIP]

> If you are familiar with Helm, a Timoni **[module](https://timoni.sh/module/)** is the equivalent of a **chart**,

> a Timoni **[bundle](https://timoni.sh/bundle/)** is the equivalent of an **umbrella chart**,

> and a Timoni **[instance](https://timoni.sh/concepts/#instance)** is the equivalent of a Helm **release**.

## Features

### App Packaging and Distribution

Timoni enables software vendors to define complex application deployments,

packaged as [Modules](https://timoni.sh/module/), using type-safe

Kubernetes templates and rich customisation options for end-users.

The app configuration packaged in a Module is

[distributed](https://timoni.sh/cue/module/publishing/) as an

Open Container Initiative (OCI) artifact, next to the app images,

in a container registry. Timoni Modules are semantically versioned

and cryptographically [signed](https://timoni.sh/cue/module/signing/).

With Timoni, platform engineers can manage the lifecycle of Kubernetes

controllers, including the upgrade of CRDs. Module authors can

[import CRD schemas](https://timoni.sh/cue/module/custom-resources/)

from YAML files and incorporate Kubernetes custom resources

in their app deployments.

### App Lifecycle Management

With Timoni, users can manage the whole lifecycle of applications deployed on Kubernetes.

From highly customised installation to seamless upgrades,

end-to-end testing, safe rollback and uninstallation.

With Timoni, users can bundle microservices and distributed monoliths into a deployable unit.

The Timoni [Bundle](https://timoni.sh/bundle/) offers a declarative way of managing

the app delivery across clusters, where secrets and other environment-specific config

values are [dynamically loaded](https://timoni.sh/bundle-runtime/) during installation or upgrades.

## License

Timoni is [Apache 2.0 licensed](LICENSE) and accepts contributions via GitHub pull requests.

Please see the [contributing guide](CONTRIBUTING.md) for more information.