main.rs

  1use anyhow::anyhow;
  2use axum::{
  3    extract::MatchedPath,
  4    http::{Request, Response},
  5    routing::get,
  6    Extension, Router,
  7};
  8use collab::{
  9    api::fetch_extensions_from_blob_store_periodically, db, env, executor::Executor, AppState,
 10    Config, RateLimiter, Result,
 11};
 12use db::Database;
 13use std::{
 14    env::args,
 15    net::{SocketAddr, TcpListener},
 16    path::Path,
 17    sync::Arc,
 18    time::Duration,
 19};
 20#[cfg(unix)]
 21use tokio::signal::unix::SignalKind;
 22use tower_http::trace::TraceLayer;
 23use tracing_subscriber::{
 24    filter::EnvFilter, fmt::format::JsonFields, util::SubscriberInitExt, Layer,
 25};
 26use util::ResultExt;
 27
 28const VERSION: &str = env!("CARGO_PKG_VERSION");
 29const REVISION: Option<&'static str> = option_env!("GITHUB_SHA");
 30
 31#[tokio::main]
 32async fn main() -> Result<()> {
 33    if let Err(error) = env::load_dotenv() {
 34        eprintln!(
 35            "error loading .env.toml (this is expected in production): {}",
 36            error
 37        );
 38    }
 39
 40    let mut args = args().skip(1);
 41    match args.next().as_deref() {
 42        Some("version") => {
 43            println!("collab v{} ({})", VERSION, REVISION.unwrap_or("unknown"));
 44        }
 45        Some("migrate") => {
 46            let config = envy::from_env::<Config>().expect("error loading config");
 47            run_migrations(&config).await?;
 48        }
 49        Some("seed") => {
 50            let config = envy::from_env::<Config>().expect("error loading config");
 51            let db_options = db::ConnectOptions::new(config.database_url.clone());
 52            let mut db = Database::new(db_options, Executor::Production).await?;
 53            db.initialize_notification_kinds().await?;
 54
 55            collab::seed::seed(&config, &db, true).await?;
 56        }
 57        Some("serve") => {
 58            let (is_api, is_collab) = if let Some(next) = args.next() {
 59                (next == "api", next == "collab")
 60            } else {
 61                (true, true)
 62            };
 63            if !is_api && !is_collab {
 64                Err(anyhow!(
 65                    "usage: collab <version | migrate | seed | serve [api|collab]>"
 66                ))?;
 67            }
 68
 69            let config = envy::from_env::<Config>().expect("error loading config");
 70            init_tracing(&config);
 71
 72            run_migrations(&config).await?;
 73
 74            let state = AppState::new(config, Executor::Production).await?;
 75
 76            let listener = TcpListener::bind(&format!("0.0.0.0:{}", state.config.http_port))
 77                .expect("failed to bind TCP listener");
 78
 79            let rpc_server = if is_collab {
 80                let epoch = state
 81                    .db
 82                    .create_server(&state.config.zed_environment)
 83                    .await?;
 84                let rpc_server = collab::rpc::Server::new(epoch, state.clone());
 85                rpc_server.start().await?;
 86
 87                Some(rpc_server)
 88            } else {
 89                None
 90            };
 91
 92            if is_collab {
 93                RateLimiter::save_periodically(state.rate_limiter.clone(), state.executor.clone());
 94            }
 95
 96            if is_api {
 97                fetch_extensions_from_blob_store_periodically(state.clone());
 98            }
 99
100            let mut app = collab::api::routes(rpc_server.clone(), state.clone());
101            if let Some(rpc_server) = rpc_server.clone() {
102                app = app.merge(collab::rpc::routes(rpc_server))
103            }
104            app = app
105                .merge(
106                    Router::new()
107                        .route("/", get(handle_root))
108                        .route("/healthz", get(handle_liveness_probe))
109                        .merge(collab::api::extensions::router())
110                        .merge(collab::api::events::router())
111                        .layer(Extension(state.clone())),
112                )
113                .layer(
114                    TraceLayer::new_for_http()
115                        .make_span_with(|request: &Request<_>| {
116                            let matched_path = request
117                                .extensions()
118                                .get::<MatchedPath>()
119                                .map(MatchedPath::as_str);
120
121                            tracing::info_span!(
122                                "http_request",
123                                method = ?request.method(),
124                                matched_path,
125                            )
126                        })
127                        .on_response(
128                            |response: &Response<_>, latency: Duration, _: &tracing::Span| {
129                                let duration_ms = latency.as_micros() as f64 / 1000.;
130                                tracing::info!(
131                                    duration_ms,
132                                    status = response.status().as_u16(),
133                                    "finished processing request"
134                                );
135                            },
136                        ),
137                );
138
139            #[cfg(unix)]
140            let signal = async move {
141                let mut sigterm = tokio::signal::unix::signal(SignalKind::terminate())
142                    .expect("failed to listen for interrupt signal");
143                let mut sigint = tokio::signal::unix::signal(SignalKind::interrupt())
144                    .expect("failed to listen for interrupt signal");
145                let sigterm = sigterm.recv();
146                let sigint = sigint.recv();
147                futures::pin_mut!(sigterm, sigint);
148                futures::future::select(sigterm, sigint).await;
149            };
150
151            #[cfg(windows)]
152            let signal = async move {
153                // todo(windows):
154                // `ctrl_close` does not work well, because tokio's signal handler always returns soon,
155                // but system termiates the application soon after returning CTRL+CLOSE handler.
156                // So we should implement blocking handler to treat CTRL+CLOSE signal.
157                let mut ctrl_break = tokio::signal::windows::ctrl_break()
158                    .expect("failed to listen for interrupt signal");
159                let mut ctrl_c = tokio::signal::windows::ctrl_c()
160                    .expect("failed to listen for interrupt signal");
161                let ctrl_break = ctrl_break.recv();
162                let ctrl_c = ctrl_c.recv();
163                futures::pin_mut!(ctrl_break, ctrl_c);
164                futures::future::select(ctrl_break, ctrl_c).await;
165            };
166
167            axum::Server::from_tcp(listener)
168                .map_err(|e| anyhow!(e))?
169                .serve(app.into_make_service_with_connect_info::<SocketAddr>())
170                .with_graceful_shutdown(async move {
171                    signal.await;
172                    tracing::info!("Received interrupt signal");
173
174                    if let Some(rpc_server) = rpc_server {
175                        rpc_server.teardown();
176                    }
177                })
178                .await
179                .map_err(|e| anyhow!(e))?;
180        }
181        _ => {
182            Err(anyhow!(
183                "usage: collab <version | migrate | seed | serve [api|collab]>"
184            ))?;
185        }
186    }
187    Ok(())
188}
189
190async fn run_migrations(config: &Config) -> Result<()> {
191    let db_options = db::ConnectOptions::new(config.database_url.clone());
192    let mut db = Database::new(db_options, Executor::Production).await?;
193
194    let migrations_path = config.migrations_path.as_deref().unwrap_or_else(|| {
195        #[cfg(feature = "sqlite")]
196        let default_migrations = concat!(env!("CARGO_MANIFEST_DIR"), "/migrations.sqlite");
197        #[cfg(not(feature = "sqlite"))]
198        let default_migrations = concat!(env!("CARGO_MANIFEST_DIR"), "/migrations");
199
200        Path::new(default_migrations)
201    });
202
203    let migrations = db.migrate(&migrations_path, false).await?;
204    for (migration, duration) in migrations {
205        log::info!(
206            "Migrated {} {} {:?}",
207            migration.version,
208            migration.description,
209            duration
210        );
211    }
212
213    db.initialize_notification_kinds().await?;
214
215    if config.seed_path.is_some() {
216        collab::seed::seed(&config, &db, false).await?;
217    }
218
219    return Ok(());
220}
221
222async fn handle_root() -> String {
223    format!("collab v{} ({})", VERSION, REVISION.unwrap_or("unknown"))
224}
225
226async fn handle_liveness_probe(Extension(state): Extension<Arc<AppState>>) -> Result<String> {
227    state.db.get_all_users(0, 1).await?;
228    Ok("ok".to_string())
229}
230
231pub fn init_tracing(config: &Config) -> Option<()> {
232    use std::str::FromStr;
233    use tracing_subscriber::layer::SubscriberExt;
234
235    let filter = EnvFilter::from_str(config.rust_log.as_deref()?).log_err()?;
236
237    tracing_subscriber::registry()
238        .with(if config.log_json.unwrap_or(false) {
239            Box::new(
240                tracing_subscriber::fmt::layer()
241                    .fmt_fields(JsonFields::default())
242                    .event_format(
243                        tracing_subscriber::fmt::format()
244                            .json()
245                            .flatten_event(true)
246                            .with_span_list(false),
247                    )
248                    .with_filter(filter),
249            ) as Box<dyn Layer<_> + Send + Sync>
250        } else {
251            Box::new(
252                tracing_subscriber::fmt::layer()
253                    .event_format(tracing_subscriber::fmt::format().pretty())
254                    .with_filter(filter),
255            )
256        })
257        .init();
258
259    None
260}