Struct Config 

pub struct Config {

    pub schema_version: String,
    pub server: ServerConfig,
    pub listeners: Vec<ListenerConfig>,
    pub routes: Vec<RouteConfig>,
    pub upstreams: HashMap<String, UpstreamConfig>,
    pub filters: HashMap<String, FilterConfig>,
    pub agents: Vec<AgentConfig>,
    pub waf: Option<WafConfig>,
    pub namespaces: Vec<NamespaceConfig>,
    pub limits: Limits,
    pub observability: ObservabilityConfig,
    pub rate_limits: GlobalRateLimitConfig,
    pub cache: Option<CacheStorageConfig>,
    pub default_upstream: Option<UpstreamPeer>,
}

Main configuration structure for Sentinel proxy

Fields

schema_version: String

Configuration schema version for compatibility checking If not specified, defaults to current version

server: ServerConfig

Global server configuration

listeners: Vec<ListenerConfig>

Listener configurations

routes: Vec<RouteConfig>

Route configurations

upstreams: HashMap<String, UpstreamConfig>

Upstream pool configurations (can be empty if all routes are static)

filters: HashMap<String, FilterConfig>

Named filter configurations (referenced by routes)

agents: Vec<AgentConfig>

Agent configurations

waf: Option<WafConfig>

WAF configuration

namespaces: Vec<NamespaceConfig>

Namespace configurations for hierarchical organization.

Namespaces provide domain-driven boundaries within the configuration, grouping related resources (routes, upstreams, agents, etc.) together. Resources within namespaces can reference each other without qualification, and can optionally be exported for global visibility.

limits: Limits

Global limits configuration

observability: ObservabilityConfig

Observability configuration

rate_limits: GlobalRateLimitConfig

Global rate limit configuration

cache: Option<CacheStorageConfig>

Global cache storage configuration

default_upstream: Option<UpstreamPeer>

Default upstream for Phase 0 testing

Implementations

impl Config

pub fn flatten(&self) -> FlattenedConfig

Flatten the hierarchical configuration into a runtime-friendly structure.

This converts all namespace/service resources into qualified IDs and collects them into flat HashMaps for efficient lookup.

impl Config

Extension methods for Config to support multi-file operations.

pub fn from_directory(path: impl AsRef<Path>) -> Result<Self>

Load configuration from a directory.

Scans the directory for KDL files and merges them into a single configuration.

pub fn from_directory_with_env( path: impl AsRef<Path>, environment: &str, ) -> Result<Self>

Load configuration with environment-specific overrides.

Uses convention-based directory structure and applies environment-specific overrides from the environments/ subdirectory.

pub fn merge(&mut self, other: Config) -> Result<()>

Merge another configuration into this one.

Fails on duplicate IDs for listeners, routes, and agents. Upstreams are merged with last-wins semantics.

impl Config

pub fn from_file(path: impl AsRef<Path>) -> Result<Self>

Load configuration from a file

pub fn default_embedded() -> Result<Self>

Load the default embedded configuration.

This is used when no configuration file is provided. It parses the embedded KDL configuration, falling back to the programmatic default if KDL parsing fails for any reason.

pub fn from_kdl(content: &str) -> Result<Self>

Parse configuration from KDL format

pub fn from_json(content: &str) -> Result<Self>

Parse configuration from JSON format

pub fn from_toml(content: &str) -> Result<Self>

Parse configuration from TOML format

pub fn check_schema_version(&self) -> SchemaCompatibility

Check schema version compatibility

pub fn validate(&self) -> SentinelResult<()>

Validate the configuration

pub fn default_for_testing() -> Self

Create a default configuration for testing

pub fn reload(&mut self, path: impl AsRef<Path>) -> SentinelResult<()>

Reload configuration from the same file path

pub fn get_route(&self, id: &str) -> Option<&RouteConfig>

Get a route by ID

pub fn get_upstream(&self, id: &str) -> Option<&UpstreamConfig>

Get an upstream by ID

pub fn get_agent(&self, id: &str) -> Option<&AgentConfig>

Get an agent by ID

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Config

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Validate for Config

fn validate(&self) -> Result<(), ValidationErrors>

impl<'v_a> ValidateArgs<'v_a> for Config

type Args = ()

fn validate_with_args(&self, args: Self::Args) -> Result<(), ValidationErrors>