https://github.com/davidmdm/yoke
Kubernetes Package Management as Code; infrastructure as code, but actually.
https://github.com/davidmdm/yoke
Last synced: about 2 months ago
JSON representation
Kubernetes Package Management as Code; infrastructure as code, but actually.
- Host: GitHub
- URL: https://github.com/davidmdm/yoke
- Owner: yokecd
- License: mit
- Created: 2024-02-14T18:32:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-18T18:31:59.000Z (about 2 months ago)
- Last Synced: 2025-04-19T06:54:09.884Z (about 2 months ago)
- Language: Go
- Size: 11.2 MB
- Stars: 388
- Watchers: 5
- Forks: 15
- Open Issues: 13
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- Contributing: contributing.md
- License: LICENSE
- Code of conduct: code-of-conduct.md
Awesome Lists containing this project
- awesome-repositories - davidmdm/yoke - (Go)
README
# yoke - Infrastructure-as-Code (IaC) Package Deployer for Kubernetes
## Overview
Yoke is a Helm-inspired infrastructure-as-code (IaC) package deployer designed to provide a more powerful, safe, and programmatic way to define and deploy packages. While Helm relies heavily on static YAML templates, Yoke takes IaC to the next level by allowing you to leverage general-purpose programming languages for defining packages, making it safer and more powerful than its predecessors.
Kubernetes packages should be described via code. Programming environments have control flow, test frameworks, static typing, documentation, error management, and versioning. They are ideal for building contracts and enforcing them.
Yoke deploys "flights" to Kubernetes (think helm charts or packages). A flight is a wasm executable that outputs the Kubernetes resources making up the package (as JSON or YAML) to stdout.
Yoke embeds a pure-Go wasm runtime (wazero) and deploys your flight to Kubernetes. It tracks revisions for each release and supports capabilities like rollbacks and inspection.
## Theme
Yoke has an aviation related theme. Core commands, for example, are named `takeoff`, `descent`, `blackbox` and `mayday`. However their less whimsical aliases exist as well: `up / apply`, and `down / rollback`.
## Installation
From source:
```bash
go install github.com/yokecd/yoke/cmd/yoke@latest
```
With Homebrew:
```bash
brew install yoke
```
## Documentation
Official documentation can be found [here](https://yokecd.github.io/docs)
## Community
Join yoke's [Discord Server](https://discord.com/invite/tHCRKg6s7Z) to discuss the yoke project, socialize, or share memes!
## Versioning
This project is still pre version 1.0.0
The project uses semantic versioning but due to is pre 1.0.0 state, breaking changes are represented as minor bumps and all other changes patches until the release of yoke v1.0.0
## Contributions
Contributions are welcome! If you encounter any issues or have suggestions, please open an issue on the yoke GitHub repository.
## License
This project is licensed under the MIT License.