autumn-plugin-pingora 0.1.0

Pingora reverse proxy for Autumn: routes, load balancing, health checks, app fallback, metrics and graceful drain
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
49

//! Errors that stop the proxy from starting.

use std::net::SocketAddr;

use crate::config::ConfigError;

/// A startup failure. Boot stops. The plugin never falls back silently.
/// Autumn shows the message in its boot error.
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum PingoraError {
    /// The configuration is not valid.
    #[error(transparent)]
    Config(#[from] ConfigError),
    /// The listener cannot bind.
    #[error("cannot bind the proxy listener on {addr}: {source}")]
    Bind {
        /// The address.
        addr: SocketAddr,
        /// The cause.
        source: std::io::Error,
    },
    /// An upstream address does not resolve.
    #[error("route `{route}`: cannot resolve upstream \"{upstream}\": {reason}")]
    Resolve {
        /// The route name.
        route: String,
        /// The upstream as configured.
        upstream: String,
        /// The cause.
        reason: String,
    },
    /// The Autumn app address does not resolve.
    #[error("cannot resolve the Autumn app address \"{0}\" for `fallback = \"app\"`")]
    AppAddress(String),
    /// The fallback target serves TLS. v0.1 has no upstream TLS.
    #[error(
        "`fallback = \"app\"` needs a plain HTTP app. `[server.tls]` is set. Put a TLS terminator in front of the proxy, or set `fallback = \"none\"`"
    )]
    FallbackTls,
    /// The proxy would send unmatched requests to itself.
    #[error(
        "the proxy address is the Autumn app address {0}. With `fallback = \"app\"`, requests would go in a loop. Set a different `bind`"
    )]
    FallbackLoop(SocketAddr),
    /// The startup hook ran again, or the proxy stopped before it started.
    #[error("the proxy started or stopped before; it can start one time only")]
    AlreadyStarted,
}