kubus 0.6.0

Derive based kubernetes operator framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# Kubus

A small Rust library for building Kubernetes operators with less boilerplate.

## Example

```rust
use std::{sync::Arc};

use k8s_openapi::api::core::v1::Pod;
use kube::{Client, ResourceExt, runtime::controller::Action};
use kubus::{Context, HandlerError, Operator, kubus};

struct State {}

#[tokio::main]
async fn main() -> Result<(), kubus::Error> {
    let client = Client::try_default().await?;
    let state = State {};

    Operator::builder()
        .with_context((client, state))
        .handler(on_pod_apply)
        .run()
        .await
}

#[kubus(event = Apply, finalizer = "kubus.io/cleanup")]
async fn on_pod_apply(pod: Arc<Pod>, _ctx: Arc<Context<State>>) -> Result<(), HandlerError> {
    let name = pod.name_unchecked();
    let namespace = pod.namespace().unwrap();

    println!("apply event for pod {name} in {namespace}");

    Ok(())
}
```

The `#[kubus]` attribute handles the watcher setup, reconciliation loop, and finalizer management. You just write functions that handle events.

## Status

Experimental - the API will probably change as I figure out what works.

## Thanks to

- [kopf](https://github.com/nolar/kopf) For the inspiration
- [kube-rs](https://github.com/kube-rs/kube) For the amazing library