rs-zero 0.2.8

Rust-first microservice framework inspired by go-zero engineering practices
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63

use std::sync::atomic::{AtomicUsize, Ordering};

use crate::discovery::ServiceInstance;

/// RPC endpoint selected from discovery.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct RpcEndpoint {
    /// Logical service name.
    pub service: String,
    /// Stable instance id.
    pub instance_id: String,
    /// Endpoint URI suitable for tonic.
    pub uri: String,
}

/// Selects RPC endpoints from instances.
pub trait RpcEndpointSelector: Send + Sync {
    /// Selects one endpoint.
    fn select(&self, service: &str, instances: &[ServiceInstance]) -> Option<RpcEndpoint>;
}

/// Weighted round-robin endpoint selector.
#[derive(Debug, Default)]
pub struct WeightedRoundRobinBalancer {
    cursor: AtomicUsize,
}

impl WeightedRoundRobinBalancer {
    /// Creates a selector.
    pub fn new() -> Self {
        Self::default()
    }
}

impl RpcEndpointSelector for WeightedRoundRobinBalancer {
    fn select(&self, service: &str, instances: &[ServiceInstance]) -> Option<RpcEndpoint> {
        let weighted = instances
            .iter()
            .filter(|instance| instance.healthy)
            .flat_map(|instance| std::iter::repeat_n(instance, instance.weight.max(1) as usize))
            .collect::<Vec<_>>();
        if weighted.is_empty() {
            return None;
        }
        let index = self.cursor.fetch_add(1, Ordering::Relaxed) % weighted.len();
        let instance = weighted[index];
        Some(endpoint_from_instance(service, instance))
    }
}

/// Builds a tonic HTTP endpoint from a service instance.
pub fn endpoint_from_instance(service: &str, instance: &ServiceInstance) -> RpcEndpoint {
    let scheme = instance
        .metadata
        .get("scheme")
        .map(String::as_str)
        .unwrap_or("http");
    RpcEndpoint {
        service: service.to_string(),
        instance_id: instance.id.clone(),
        uri: format!("{scheme}://{}", instance.endpoint.authority()),
    }
}