Struct HttpServerConfig 

pub struct HttpServerConfig {
    pub bind_address: String,
    pub request_timeout_ms: u64,
    pub keep_alive_timeout_ms: u64,
    pub max_connections: usize,
    pub enable_health_endpoints: bool,
    pub enable_metrics_endpoint: bool,
    pub enable_config_endpoint: bool,
    pub enable_http2: bool,
    pub tls_cert_path: Option<String>,
    pub tls_key_path: Option<String>,
    pub shutdown_timeout_ms: u64,
}

Available on crate feature http-server only.

HTTP server configuration.

Fields

bind_address: String

Address to bind to (e.g., “0.0.0.0:8080”).

request_timeout_ms: u64

Request timeout in milliseconds. Defaults to 30 seconds.

keep_alive_timeout_ms: u64

Keep-alive timeout in ms. Default 75 s.

Not wired. axum 0.8 serve() doesn’t surface keep-alive; needs hyper builder. Follow-up.

max_connections: usize

In-flight request cap. Default 10,000. Enforced via tower::limit::ConcurrencyLimitLayer. Excess requests queue.

enable_health_endpoints: bool

Mount /health/live + /health/ready. Default true.

enable_metrics_endpoint: bool

Mount /metrics.

Not wired here. MetricsManager owns its own /metrics listener (often a separate admin port). Forward-compat for framework-managed wiring.

enable_config_endpoint: bool

Mount /config (redacted effective config). Default false.

enable_http2: bool

HTTP/2 (also required for gRPC).

Not wired. axum 0.8 serve() always negotiates HTTP/1 and HTTP/2 on cleartext. Disabling needs hyper builder.

tls_cert_path: Option<String>

TLS cert path (PEM).

Not wired. Needs axum_server::tls_rustls (not a dep). K8s pattern: terminate TLS at Ingress / Service Mesh, cleartext in-pod.

tls_key_path: Option<String>

TLS key path (PEM). See tls_cert_path – not wired.

shutdown_timeout_ms: u64

Graceful drain budget in ms. Default 30 s. Caps drain time to fit under K8s terminationGracePeriodSeconds.

Implementations

impl HttpServerConfig

pub fn new(bind_address: impl Into<String>) -> Self

Create a new config with the given bind address.

pub fn request_timeout(&self) -> Duration

Get request timeout as Duration.

pub fn keep_alive_timeout(&self) -> Duration

Get keep-alive timeout as Duration.

pub fn shutdown_timeout(&self) -> Duration

Get shutdown timeout as Duration.

pub fn is_tls_enabled(&self) -> bool

Whether TLS cert+key paths are present in config.

NOTE: this only reports that the fields are set – in-process TLS is NOT terminated by this server (see tls_cert_path). Use validate at startup so a config that expects in-pod TLS fails loudly instead of silently serving cleartext.

pub fn validate(&self) -> Result<(), String>

Validate the server config (finding 10: is_tls_enabled must not lie).

In-process TLS termination is not supported – the K8s pattern is to terminate TLS at the ingress / service mesh and run cleartext in-pod. If tls_cert_path/tls_key_path are set, the operator expects in-pod TLS that will not happen, so this errors rather than letting the server bind cleartext while the config claims TLS. Call at startup.

Errors

Returns Err if either TLS path is set.

Trait Implementations

impl Clone for HttpServerConfig

fn clone(&self) -> HttpServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpServerConfig

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

Formats the value using the given formatter.

impl Default for HttpServerConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HttpServerConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HttpServerConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.