balter 0.3.0

A load/stress testing framework.
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

use crate::{
    gossip::{receive_gossip, SharedGossipData},
    runtime::BALTER_IN,
    scenario::ScenarioConfig,
};
use async_channel::Sender;
use axum::{
    extract::{
        connect_info::ConnectInfo,
        ws::{WebSocket, WebSocketUpgrade},
        Json, State,
    },
    http::StatusCode,
    response::{IntoResponse, Response},
    routing::{get, post},
    Router,
};
use std::{net::SocketAddr, sync::Arc};
use thiserror::Error;
use tower::ServiceBuilder;
use tower_http::trace::TraceLayer;
use tracing::{error, instrument};

#[derive(Error, Debug)]
pub(crate) enum ServerError {
    #[error("Address Parsing Error")]
    AddrParseError(#[from] std::net::AddrParseError),

    #[error("Address Parsing Error")]
    IoError(#[from] std::io::Error),
}

pub(crate) async fn server_task(port: u16, peers: SharedGossipData) -> Result<(), ServerError> {
    let (ref runtime_tx, _) = *BALTER_IN;
    let runtime_tx = runtime_tx.clone();
    let state = ServerState { peers, runtime_tx };

    let app = Router::new()
        .route("/run", post(run_scenario))
        .route("/info-ws", get(info_ws))
        .with_state(Arc::new(state))
        .layer(ServiceBuilder::new().layer(TraceLayer::new_for_http()))
        .into_make_service_with_connect_info::<SocketAddr>();

    let socket_addr: SocketAddr = format!("0.0.0.0:{port}").parse()?;
    let listener = tokio::net::TcpListener::bind(socket_addr).await?;

    axum::serve(listener, app).await?;

    Ok(())
}

struct ServerState {
    peers: SharedGossipData,
    runtime_tx: Sender<ScenarioConfig>,
}

#[derive(Error, Debug)]
enum HandlerError {
    #[error("Channel send error (Balter runtime has likely fallen over): {0}")]
    SendError(#[from] async_channel::SendError<ScenarioConfig>),
}

impl IntoResponse for HandlerError {
    fn into_response(self) -> Response {
        use HandlerError::*;
        match self {
            SendError(err) => (
                StatusCode::INTERNAL_SERVER_ERROR,
                format!("Internal error: {err:?}"),
            ),
        }
        .into_response()
    }
}

type HResult<T> = Result<T, HandlerError>;

#[instrument(skip(state))]
async fn run_scenario(
    State(state): State<Arc<ServerState>>,
    Json(scenario): Json<ScenarioConfig>,
) -> HResult<String> {
    let output = format!("Running scenario {}", &scenario.name);

    // TODO: Query runtime statistics to ensure this server can handle additional load.
    state.runtime_tx.send(scenario).await?;

    Ok(output)
}

async fn info_ws(
    State(state): State<Arc<ServerState>>,
    connection_info: ConnectInfo<SocketAddr>,
    ws: WebSocketUpgrade,
) -> Response {
    ws.on_upgrade(move |socket| handle_socket(socket, state, connection_info.0))
}

async fn handle_socket(socket: WebSocket, state: Arc<ServerState>, addr: SocketAddr) {
    if let Err(err) = receive_gossip(socket, &state.peers, addr).await {
        error!("Error in gossip: {err:?}");
    }
}