mirror of
https://github.com/TECHNOFAB11/kubenix.git
synced 2025-12-12 08:00:06 +01:00
56 lines
1.2 KiB
Markdown
56 lines
1.2 KiB
Markdown
# kubenix
|
|
|
|
Kubernetes resource management with Nix
|
|
|
|
<p align="center" style="margin: 2em auto;">
|
|
<img src="./docs/logo.svg" alt="nixos logo in kubernetes blue" width="350"/>
|
|
</p>
|
|
|
|
> **WARN**: this is a work in progress, expect breaking changes
|
|
|
|
## Usage
|
|
|
|
Apply all resources with
|
|
|
|
nix run github:hall/kubenix . -- apply
|
|
|
|
> **HINT**: run `nix run github:hall/kubenix . -- --help` for more commands
|
|
|
|
A minimal example flake:
|
|
|
|
```nix
|
|
{
|
|
inputs.kubenix = "github:hall/kubenix";
|
|
outputs = {self, ...}@inputs: {
|
|
nixosConfigurations.hostname = {
|
|
modules = [ inputs.kubenix.nixosModule ];
|
|
};
|
|
kubernetes.resources.pods."app" = {
|
|
spec.containers."app" = {
|
|
name = "app";
|
|
image = "nginx";
|
|
};
|
|
};
|
|
}
|
|
}
|
|
```
|
|
|
|
<!-- A more complete example config:
|
|
|
|
```nix
|
|
{
|
|
kubernetes = {
|
|
context = "default";
|
|
resources = {};
|
|
helm = {
|
|
releases = {};
|
|
};
|
|
}
|
|
}
|
|
``` -->
|
|
|
|
## Attribution
|
|
|
|
This project was forked from https://github.com/GTrunSec/kubenix which was forked from https://github.com/xtruder/kubenix.
|
|
|
|
Logo is a mishmash of the [Kubernetes wheel](https://github.com/kubernetes/kubernetes/blob/master/logo/logo.svg) and the [NixOs snowflake](https://github.com/NixOS/nixos-artwork/blob/master/logo/white.svg).
|