src/lib.rs

   1 pub mod api_routes_http;
   2 pub mod api_routes_websocket;
   3 pub mod code_migrations;
   4 pub mod root_span_builder;
   5 pub mod scheduled_tasks;
   6 #[cfg(feature = "console")]
   7 pub mod telemetry;
   8
   9 use crate::{code_migrations::run_advanced_migrations, root_span_builder::QuieterRootSpanBuilder};
  10 use actix_web::{middleware, web::Data, App, HttpServer, Result};
  11 use doku::json::{AutoComments, CommentsStyle, Formatting, ObjectsStyle};
  12 use lemmy_api_common::{
  13   context::LemmyContext,
  14   lemmy_db_views::structs::SiteView,
  15   request::build_user_agent,
  16   utils::{
  17     check_private_instance_and_federation_enabled,
  18     local_site_rate_limit_to_rate_limit_config,
  19   },
  20   websocket::chat_server::ChatServer,
  21 };
  22 use lemmy_db_schema::{
  23   source::secret::Secret,
  24   utils::{build_db_pool, get_database_url, run_migrations},
  25 };
  26 use lemmy_routes::{feeds, images, nodeinfo, webfinger};
  27 use lemmy_utils::{
  28   error::LemmyError,
  29   rate_limit::RateLimitCell,
  30   settings::{structs::Settings, SETTINGS},
  31 };
  32 use reqwest::Client;
  33 use reqwest_middleware::ClientBuilder;
  34 use reqwest_retry::{policies::ExponentialBackoff, RetryTransientMiddleware};
  35 use reqwest_tracing::TracingMiddleware;
  36 use std::{env, sync::Arc, thread, time::Duration};
  37 use tracing::subscriber::set_global_default;
  38 use tracing_actix_web::TracingLogger;
  39 use tracing_error::ErrorLayer;
  40 use tracing_log::LogTracer;
  41 use tracing_subscriber::{filter::Targets, layer::SubscriberExt, Layer, Registry};
  42 use url::Url;
  43
  44 /// Max timeout for http requests
  45 const REQWEST_TIMEOUT: Duration = Duration::from_secs(10);
  46
  47 /// Placing the main function in lib.rs allows other crates to import it and embed Lemmy
  48 pub async fn start_lemmy_server() -> Result<(), LemmyError> {
  49   let args: Vec<String> = env::args().collect();
  50   if args.len() == 2 && args[1] == "--print-config-docs" {
  51     let fmt = Formatting {
  52       auto_comments: AutoComments::none(),
  53       comments_style: CommentsStyle {
  54         separator: "#".to_owned(),
  55       },
  56       objects_style: ObjectsStyle {
  57         surround_keys_with_quotes: false,
  58         use_comma_as_separator: false,
  59       },
  60       ..Default::default()
  61     };
  62     println!("{}", doku::to_json_fmt_val(&fmt, &Settings::default()));
  63     return Ok(());
  64   }
  65
  66   let settings = SETTINGS.to_owned();
  67
  68   // Set up the bb8 connection pool
  69   let db_url = get_database_url(Some(&settings));
  70   run_migrations(&db_url);
  71
  72   // Run the migrations from code
  73   let pool = build_db_pool(&settings).await?;
  74   run_advanced_migrations(&pool, &settings).await?;
  75
  76   // Schedules various cleanup tasks for the DB
  77   thread::spawn(move || {
  78     scheduled_tasks::setup(db_url).expect("Couldn't set up scheduled_tasks");
  79   });
  80
  81   // Initialize the secrets
  82   let secret = Secret::init(&pool)
  83     .await
  84     .expect("Couldn't initialize secrets.");
  85
  86   // Make sure the local site is set up.
  87   let site_view = SiteView::read_local(&pool)
  88     .await
  89     .expect("local site not set up");
  90   let local_site = site_view.local_site;
  91   let federation_enabled = local_site.federation_enabled;
  92
  93   if federation_enabled {
  94     println!("federation enabled, host is {}", &settings.hostname);
  95   }
  96
  97   check_private_instance_and_federation_enabled(&local_site)?;
  98
  99   // Set up the rate limiter
 100   let rate_limit_config =
 101     local_site_rate_limit_to_rate_limit_config(&site_view.local_site_rate_limit);
 102   let rate_limit_cell = RateLimitCell::new(rate_limit_config).await;
 103
 104   println!(
 105     "Starting http server at {}:{}",
 106     settings.bind, settings.port
 107   );
 108
 109   let reqwest_client = Client::builder()
 110     .user_agent(build_user_agent(&settings))
 111     .timeout(REQWEST_TIMEOUT)
 112     .build()?;
 113
 114   let retry_policy = ExponentialBackoff {
 115     max_n_retries: 3,
 116     max_retry_interval: REQWEST_TIMEOUT,
 117     min_retry_interval: Duration::from_millis(100),
 118     backoff_exponent: 2,
 119   };
 120
 121   let client = ClientBuilder::new(reqwest_client.clone())
 122     .with(TracingMiddleware::default())
 123     .with(RetryTransientMiddleware::new_with_policy(retry_policy))
 124     .build();
 125
 126   // Pictrs cannot use the retry middleware
 127   let pictrs_client = ClientBuilder::new(reqwest_client.clone())
 128     .with(TracingMiddleware::default())
 129     .build();
 130
 131   let chat_server = Arc::new(ChatServer::startup());
 132
 133   // Create Http server with websocket support
 134   let settings_bind = settings.clone();
 135   HttpServer::new(move || {
 136     let context = LemmyContext::create(
 137       pool.clone(),
 138       chat_server.clone(),
 139       client.clone(),
 140       settings.clone(),
 141       secret.clone(),
 142       rate_limit_cell.clone(),
 143     );
 144     App::new()
 145       .wrap(middleware::Logger::default())
 146       .wrap(TracingLogger::<QuieterRootSpanBuilder>::new())
 147       .app_data(Data::new(context))
 148       .app_data(Data::new(rate_limit_cell.clone()))
 149       // The routes
 150       .configure(|cfg| api_routes_http::config(cfg, rate_limit_cell))
 151       .configure(|cfg| {
 152         if federation_enabled {
 153           lemmy_apub::http::routes::config(cfg);
 154           webfinger::config(cfg);
 155         }
 156       })
 157       .configure(feeds::config)
 158       .configure(|cfg| images::config(cfg, pictrs_client.clone(), rate_limit_cell))
 159       .configure(nodeinfo::config)
 160   })
 161   .bind((settings_bind.bind, settings_bind.port))?
 162   .run()
 163   .await?;
 164
 165   Ok(())
 166 }
 167
 168 pub fn init_logging(opentelemetry_url: &Option<Url>) -> Result<(), LemmyError> {
 169   LogTracer::init()?;
 170
 171   let log_description = std::env::var("RUST_LOG").unwrap_or_else(|_| "info".into());
 172
 173   let targets = log_description
 174     .trim()
 175     .trim_matches('"')
 176     .parse::<Targets>()?;
 177
 178   let format_layer = tracing_subscriber::fmt::layer().with_filter(targets.clone());
 179
 180   let subscriber = Registry::default()
 181     .with(format_layer)
 182     .with(ErrorLayer::default());
 183
 184   if let Some(_url) = opentelemetry_url {
 185     #[cfg(feature = "console")]
 186     telemetry::init_tracing(_url.as_ref(), subscriber, targets)?;
 187     #[cfg(not(feature = "console"))]
 188     tracing::error!("Feature `console` must be enabled for opentelemetry tracing");
 189   } else {
 190     set_global_default(subscriber)?;
 191   }
 192
 193   Ok(())
 194 }