Struct RaftNodeConfig 

pub struct RaftNodeConfig {
    pub cluster: ClusterConfig,
    pub network: NetworkConfig,
    pub raft: RaftConfig,
    pub retry: RetryPolicies,
    pub tls: TlsConfig,
}

Main configuration container for Raft consensus engine components

Combines all subsystem configurations with hierarchical override support:

1. Default values from code implementation
2. Configuration file specified by CONFIG_PATH
3. Environment variables (highest priority)

Fields

cluster: ClusterConfig

Cluster topology and node configuration

network: NetworkConfig

Network communication parameters

raft: RaftConfig

Core Raft algorithm parameters

retry: RetryPolicies

Retry policies for distributed operations

tls: TlsConfig

TLS/SSL security configuration

Implementations

impl RaftNodeConfig

pub fn new() -> Result<Self>

Loads configuration from hierarchical sources without validation.

Configuration sources are merged in the following order (later sources override earlier):

1. Type defaults (lowest priority)
2. Configuration file from CONFIG_PATH environment variable (if set)
3. Environment variables with RAFT__ prefix (highest priority)

Note

This method does NOT validate the configuration. Validation is deferred to allow further overrides via with_override_config(). Callers MUST call validate() before using the configuration.

Returns

Merged configuration instance or error if config file parsing fails.

Examples

// Load with default values only
let cfg = RaftNodeConfig::new()?.validate()?;

// Load with config file and environment variables
std::env::set_var("CONFIG_PATH", "config/cluster.toml");
std::env::set_var("RAFT__CLUSTER__NODE_ID", "100");
let cfg = RaftNodeConfig::new()?.validate()?;

// Apply runtime overrides
let cfg = RaftNodeConfig::new()?
    .with_override_config("custom.toml")?
    .validate()?;

pub fn with_override_config(&self, path: &str) -> Result<Self>

Applies additional configuration overrides from file without validation.

Merging order (later sources override earlier):

1. Current configuration values
2. New configuration file
3. Latest environment variables (highest priority)

Note

This method does NOT validate the configuration. Callers MUST call validate() after all overrides are applied.

Example

let cfg = RaftNodeConfig::new()?
    .with_override_config("runtime_overrides.toml")?
    .validate()?;

pub fn validate(self) -> Result<Self>

Validates configuration and returns validated instance.

Consumes self and performs validation of all subsystems. Must be called after all configuration overrides to ensure the final config is valid.

Returns

Validated configuration or error if validation fails.

Errors

Returns validation errors from any subsystem:

• Invalid port bindings
• Conflicting node IDs
• Expired certificates
• Invalid directory paths

Example

let config = RaftNodeConfig::new()?
    .with_override_config("app.toml")?
    .validate()?; // Validation happens here

pub fn is_learner(&self) -> bool

Checks if this node is configured as a learner (not a voter)

A learner node has role=Learner. Only learners can join via JoinCluster RPC. Voters have role=Follower/Candidate/Leader and are added via config change (AddNode).

Note: Status (Promotable/ReadOnly/Active) is separate from role. This method checks role only.

Trait Implementations

impl Clone for RaftNodeConfig

fn clone(&self) -> RaftNodeConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RaftNodeConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RaftNodeConfig

fn default() -> RaftNodeConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RaftNodeConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RaftNodeConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.