Struct FileBackendConfig 

pub struct FileBackendConfig {
    pub address: String,
    pub weight: Option<u8>,
    pub sticky_id: Option<String>,
    pub backup: Option<bool>,
    pub backend_id: Option<String>,
    pub unix_path: Option<String>,
}

A backend as written in the configuration file. address is either a socket address ("127.0.0.1:8080", "[::1]:8080") or a host:port ("ingress:8080") that FileBackendConfig::resolve turns into one BackendConfig per resolved address when the file is loaded (sozu-proxy/sozu#347). Workers only ever receive socket addresses.

Fields

address: String

weight: Option<u8>

sticky_id: Option<String>

backup: Option<bool>

backend_id: Option<String>

unix_path: Option<String>

Carried unchanged onto every backend this entry resolves to; see BackendConfig::unix_path.

Implementations

impl FileBackendConfig

pub fn resolve( &self, cluster_id: &str, index: usize, resolver: &BackendResolver<'_>, ) -> Result<Vec<BackendConfig>, ConfigError>

Resolves this entry into backends, once, through resolver (system_resolver outside tests).

A socket-address literal never reaches the resolver and keeps its configured backend_id, or the positional default id <cluster_id>-<index>-<address>, where index is the entry’s position in the file’s backends list, so it does not move when a name before it resolves to more or fewer addresses. A host:port yields one backend per distinct resolved address, sorted so the result does not depend on the resolver’s answer order, each with a deterministic id: <backend_id>-<address> when backend_id is set, <cluster_id>-<host:port>-<address> otherwise. When the name resolves, a configured sticky_id is suffixed with -<address> too, so it stays unique in the cluster and does not change when the answer grows or shrinks.

A host made only of dot-separated decimal, octal or 0x hexadecimal components that is not a valid IP literal (010.0.0.1, 1.2.3, 0x7f.1) is refused before the resolver: getaddrinfo reads such strings as legacy inet_aton shorthand (8.0.0.1, 1.2.0.3, 127.0.0.1), which the socket-address parser always rejected. An unbracketed IPv6 literal (::1:8080) is refused the same way: getaddrinfo would split it on the last colon.

Trait Implementations

impl Clone for FileBackendConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileBackendConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileBackendConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FileBackendConfig

impl Hash for FileBackendConfig

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for FileBackendConfig

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for FileBackendConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FileBackendConfig