engenho-config 0.1.2

engenho-config — the top-level shikumi-back typed configuration surface for the whole engenho substrate. EngenhoConfig owns cluster + revoada + teia + scheduler + controllers + consistency sub-structs; each provides shikumi::TieredConfig with reasonable prescribed_default()s so 90% of operators get a working substrate from cargo run.
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

//! engenho-controllers tunables + per-controller toggles.

use serde::{Deserialize, Serialize};
use shikumi::TieredConfig;

use crate::error::ConfigError;

/// Controllers config — per-controller enable toggles + runtime
/// tunables.
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct ControllersConfig {
    /// Per-controller enable toggles.
    pub enable: ControllerEnable,
    /// Namespace scope (empty = all).
    pub namespace: String,
    /// WatchDriver fallback tick interval (seconds).
    pub fallback_interval_seconds: u32,
    /// WatchDriver event-coalescing window (milliseconds).
    pub debounce_milliseconds: u32,
}

/// Per-controller enable flags.
#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
#[serde(deny_unknown_fields)]
pub struct ControllerEnable {
    /// ReplicaSet → Pod controller.
    pub replicaset: bool,
    /// Deployment → ReplicaSet controller.
    pub deployment: bool,
    /// Service → Endpoints controller.
    pub endpoints: bool,
    /// Owner-reference garbage collector.
    pub gc: bool,
}

impl TieredConfig for ControllersConfig {
    fn bare() -> Self {
        Self {
            enable: ControllerEnable {
                replicaset: false,
                deployment: false,
                endpoints: false,
                gc: false,
            },
            namespace: String::new(),
            fallback_interval_seconds: 0,
            debounce_milliseconds: 0,
        }
    }

    fn prescribed_default() -> Self {
        Self {
            enable: ControllerEnable {
                replicaset: true,
                deployment: true,
                endpoints: true,
                gc: true,
            },
            namespace: String::new(),
            fallback_interval_seconds: 30,
            debounce_milliseconds: 50,
        }
    }

    fn extend(self, base: &Self) -> Self {
        Self {
            enable: self.enable,
            namespace: if self.namespace.is_empty() {
                base.namespace.clone()
            } else {
                self.namespace
            },
            fallback_interval_seconds: if self.fallback_interval_seconds == 0 {
                base.fallback_interval_seconds
            } else {
                self.fallback_interval_seconds
            },
            debounce_milliseconds: if self.debounce_milliseconds == 0 {
                base.debounce_milliseconds
            } else {
                self.debounce_milliseconds
            },
        }
    }
}

impl ControllersConfig {
    /// Validate the controllers config.
    ///
    /// # Errors
    ///
    /// Returns [`ConfigError::InvalidField`] when fallback interval is zero.
    pub fn validate(&self) -> Result<(), ConfigError> {
        if self.fallback_interval_seconds == 0 {
            return Err(ConfigError::InvalidField {
                field: "controllers.fallback_interval_seconds".into(),
                reason: "fallback interval must be > 0".into(),
            });
        }
        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn prescribed_default_enables_all_controllers_and_validates() {
        let cfg = ControllersConfig::prescribed_default();
        assert!(cfg.enable.replicaset);
        assert!(cfg.enable.deployment);
        assert!(cfg.enable.endpoints);
        assert!(cfg.enable.gc);
        cfg.validate().unwrap();
    }

    #[test]
    fn bare_disables_everything_and_fails_validation() {
        let cfg = ControllersConfig::bare();
        assert!(!cfg.enable.replicaset);
        assert!(cfg.validate().is_err());
    }
}