itsi-server 0.1.1 → 0.1.13

data/ext/itsi_server/src/server/serve_strategy/cluster_mode.rs

@@ -0,0 +1,337 @@
+use crate::ruby_types::itsi_server::itsi_server_config::ItsiServerConfig;
+use crate::server::signal::SIGNAL_HANDLER_CHANNEL;
+use crate::server::{lifecycle_event::LifecycleEvent, process_worker::ProcessWorker};
+use itsi_error::{ItsiError, Result};
+use itsi_rb_helpers::{
+    call_proc_and_log_errors, call_with_gvl, call_without_gvl, create_ruby_thread,
+};
+use itsi_tracing::{error, info, warn};
+use magnus::Value;
+use nix::{libc::exit, unistd::Pid};
+
+use std::{
+    sync::{atomic::AtomicUsize, Arc},
+    time::{Duration, Instant},
+};
+use tokio::{
+    runtime::{Builder as RuntimeBuilder, Runtime},
+    sync::{broadcast, watch, Mutex},
+    time::{self, sleep},
+};
+use tracing::{debug, instrument};
+pub(crate) struct ClusterMode {
+    pub server_config: Arc<ItsiServerConfig>,
+    pub process_workers: parking_lot::Mutex<Vec<ProcessWorker>>,
+    pub lifecycle_channel: broadcast::Sender<LifecycleEvent>,
+}
+
+static WORKER_ID: AtomicUsize = AtomicUsize::new(0);
+static CHILD_SIGNAL_SENDER: parking_lot::Mutex<Option<watch::Sender<()>>> =
+    parking_lot::Mutex::new(None);
+
+impl ClusterMode {
+    pub fn new(server_config: Arc<ItsiServerConfig>) -> Self {
+        let process_workers = (0..server_config.server_params.read().workers)
+            .map(|_| ProcessWorker {
+                worker_id: WORKER_ID.fetch_add(1, std::sync::atomic::Ordering::Relaxed),
+                ..Default::default()
+            })
+            .collect();
+
+        Self {
+            server_config,
+            process_workers: parking_lot::Mutex::new(process_workers),
+            lifecycle_channel: SIGNAL_HANDLER_CHANNEL.0.clone(),
+        }
+    }
+
+    pub fn build_runtime(&self) -> Runtime {
+        let mut builder: RuntimeBuilder = RuntimeBuilder::new_current_thread();
+        builder
+            .thread_name("itsi-server-accept-loop")
+            .thread_stack_size(3 * 1024 * 1024)
+            .enable_io()
+            .enable_time()
+            .build()
+            .expect("Failed to build Tokio runtime")
+    }
+
+    #[allow(clippy::await_holding_lock)]
+    pub async fn handle_lifecycle_event(
+        self: Arc<Self>,
+        lifecycle_event: LifecycleEvent,
+    ) -> Result<()> {
+        match lifecycle_event {
+            LifecycleEvent::Start => Ok(()),
+            LifecycleEvent::PrintInfo => {
+                self.print_info().await?;
+                Ok(())
+            }
+            LifecycleEvent::Shutdown => {
+                self.server_config.stop_watcher()?;
+                self.shutdown().await?;
+                Ok(())
+            }
+            LifecycleEvent::Restart => {
+                self.server_config.dup_fds()?;
+                self.shutdown().await.ok();
+                info!("Shutdown complete. Calling reload exec");
+                self.server_config.reload_exec()?;
+                Ok(())
+            }
+            LifecycleEvent::Reload => {
+                let should_reexec = self.server_config.clone().reload(true)?;
+                if should_reexec {
+                    self.server_config.dup_fds()?;
+                    self.shutdown().await.ok();
+                    self.server_config.reload_exec()?;
+                }
+                let mut workers_to_load = self.server_config.server_params.read().workers;
+                let mut next_workers = Vec::new();
+                for worker in self.process_workers.lock().drain(..) {
+                    if workers_to_load == 0 {
+                        worker.graceful_shutdown(self.clone()).await
+                    } else {
+                        workers_to_load -= 1;
+                        worker.reboot(self.clone()).await?;
+                        next_workers.push(worker);
+                    }
+                }
+                self.process_workers.lock().extend(next_workers);
+                while workers_to_load > 0 {
+                    let mut workers = self.process_workers.lock();
+                    let worker = ProcessWorker {
+                        worker_id: WORKER_ID.fetch_add(1, std::sync::atomic::Ordering::Relaxed),
+                        ..Default::default()
+                    };
+                    let worker_clone = worker.clone();
+                    let self_clone = self.clone();
+                    create_ruby_thread(move || {
+                        call_without_gvl(move || {
+                            worker_clone.boot(self_clone).ok();
+                        })
+                    });
+                    workers.push(worker);
+                    workers_to_load -= 1
+                }
+                Ok(())
+            }
+            LifecycleEvent::IncreaseWorkers => {
+                let mut workers = self.process_workers.lock();
+                let worker = ProcessWorker {
+                    worker_id: WORKER_ID.fetch_add(1, std::sync::atomic::Ordering::Relaxed),
+                    ..Default::default()
+                };
+                let worker_clone = worker.clone();
+                let self_clone = self.clone();
+                create_ruby_thread(move || {
+                    call_without_gvl(move || {
+                        worker_clone.boot(self_clone).ok();
+                    })
+                });
+                workers.push(worker);
+                Ok(())
+            }
+            LifecycleEvent::DecreaseWorkers => {
+                let worker = {
+                    let mut workers = self.process_workers.lock();
+                    workers.pop()
+                };
+                if let Some(dropped_worker) = worker {
+                    dropped_worker.request_shutdown();
+                    let force_kill_time = Instant::now()
+                        + Duration::from_secs_f64(
+                            self.server_config.server_params.read().shutdown_timeout,
+                        );
+                    while dropped_worker.is_alive() && force_kill_time > Instant::now() {
+                        tokio::time::sleep(Duration::from_millis(100)).await;
+                    }
+                    if dropped_worker.is_alive() {
+                        dropped_worker.force_kill();
+                    }
+                };
+                Ok(())
+            }
+            LifecycleEvent::ForceShutdown => {
+                for worker in self.process_workers.lock().iter() {
+                    worker.force_kill();
+                }
+                error!("Force shutdown!");
+                unsafe { exit(0) };
+            }
+            LifecycleEvent::ChildTerminated => {
+                CHILD_SIGNAL_SENDER.lock().as_ref().inspect(|i| {
+                    i.send(()).ok();
+                });
+                Ok(())
+            }
+        }
+    }
+
+    pub async fn shutdown(&self) -> Result<()> {
+        let shutdown_timeout = self.server_config.server_params.read().shutdown_timeout;
+        let workers = self.process_workers.lock().clone();
+
+        workers.iter().for_each(|worker| worker.request_shutdown());
+
+        let remaining_children = Arc::new(Mutex::new(workers.len()));
+        let monitor_handle = {
+            let remaining_children: Arc<Mutex<usize>> = Arc::clone(&remaining_children);
+            let mut workers = workers.clone();
+            tokio::spawn(async move {
+                loop {
+                    // Check if all workers have exited
+                    let mut remaining = remaining_children.lock().await;
+                    workers.retain(|worker| worker.is_alive());
+                    *remaining = workers.len();
+                    if *remaining == 0 {
+                        break;
+                    }
+                    sleep(Duration::from_millis(100)).await;
+                }
+            })
+        };
+
+        tokio::select! {
+            _ = monitor_handle => {
+              debug!("All children exited early, exit normally")
+            }
+            _ = sleep(Duration::from_secs_f64(shutdown_timeout)) => {
+                warn!("Graceful shutdown timeout reached, force killing remaining children");
+                workers.iter().for_each(|worker| worker.force_kill());
+            }
+        }
+
+        Err(ItsiError::Break())
+    }
+
+    pub async fn print_info(self: Arc<Self>) -> Result<()> {
+        println!("Itsi Cluster Info:");
+        println!("Master PID: {:?}", Pid::this());
+        if let Some(memory_limit) = self.server_config.server_params.read().worker_memory_limit {
+            println!("Worker Memory Limit: {}", memory_limit);
+        }
+
+        if self.server_config.watcher_fd.is_some() {
+            println!("File Watcher Enabled: true",);
+            if let Some(watchers) = self
+                .server_config
+                .server_params
+                .read()
+                .notify_watchers
+                .as_ref()
+            {
+                for watcher in watchers {
+                    println!(
+                        "Watching path: {} => {}",
+                        watcher.0,
+                        watcher
+                            .1
+                            .iter()
+                            .map(|path| path.join(","))
+                            .collect::<Vec<String>>()
+                            .join(" ")
+                    );
+                }
+            }
+        }
+        println!(
+            "Silent Mode: {}",
+            self.server_config.server_params.read().silence
+        );
+        println!(
+            "Preload: {}",
+            self.server_config.server_params.read().preload
+        );
+        let workers = self.process_workers.lock().clone();
+        for worker in workers {
+            worker.print_info()?;
+            sleep(Duration::from_millis(50)).await;
+        }
+        Ok(())
+    }
+
+    pub fn stop(&self) -> Result<()> {
+        for worker in self.process_workers.lock().iter() {
+            if worker.is_alive() {
+                worker.force_kill();
+            }
+        }
+        Ok(())
+    }
+
+    #[instrument(skip(self), fields(mode = "cluster", pid=format!("{:?}", Pid::this())))]
+    pub fn run(self: Arc<Self>) -> Result<()> {
+        info!("Starting in Cluster mode");
+        if let Some(proc) = self
+            .server_config
+            .server_params
+            .read()
+            .hooks
+            .get("before_fork")
+        {
+            call_with_gvl(|_| call_proc_and_log_errors(proc.clone()))
+        }
+        self.process_workers
+            .lock()
+            .iter()
+            .try_for_each(|worker| worker.boot(Arc::clone(&self)))?;
+
+        let (sender, mut receiver) = watch::channel(());
+        *CHILD_SIGNAL_SENDER.lock() = Some(sender);
+
+        let mut lifecycle_rx = self.lifecycle_channel.subscribe();
+        let self_ref = self.clone();
+
+        self.build_runtime().block_on(async {
+          let self_ref = self_ref.clone();
+          let mut memory_check_interval = time::interval(time::Duration::from_secs(2));
+          loop {
+            tokio::select! {
+              _ = receiver.changed() => {
+                let mut workers = self_ref.process_workers.lock();
+                workers.retain(|worker| {
+                  worker.boot_if_dead(self_ref.clone())
+                });
+                if workers.is_empty() {
+                    warn!("No workers running. Send SIGTTIN to increase worker count");
+                }
+              }
+              _ = memory_check_interval.tick() => {
+                let worker_memory_limit = self_ref.server_config.server_params.read().worker_memory_limit;
+                if let Some(memory_limit) = worker_memory_limit {
+                  let largest_worker = {
+                    let workers = self_ref.process_workers.lock();
+                    workers.iter().max_by(|wa, wb| wa.memory_usage().cmp(&wb.memory_usage())).cloned()
+                  };
+                  if let Some(largest_worker) = largest_worker {
+                    if let Some(current_mem_usage) = largest_worker.memory_usage(){
+                      if current_mem_usage > memory_limit {
+                        largest_worker.reboot(self_ref.clone()).await.ok();
+                        if let Some(hook) = self_ref.server_config.server_params.read().hooks.get("after_memory_threshold_reached") {
+                          call_with_gvl(|_|  hook.call::<_, Value>((largest_worker.pid(),)).ok() );
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+              lifecycle_event = lifecycle_rx.recv() => match lifecycle_event{
+                Ok(lifecycle_event) => {
+                  if let Err(e) = self_ref.clone().handle_lifecycle_event(lifecycle_event).await{
+                    match e {
+                      ItsiError::Break() => break,
+                      _ => error!("Error in handle_lifecycle_event {:?}", e)
+                    }
+                  }
+
+                },
+                Err(e) => error!("Error receiving lifecycle_event: {:?}", e),
+              }
+            }
+          }
+        });
+
+        Ok(())
+    }
+}

data/ext/itsi_server/src/server/serve_strategy/mod.rs

@@ -0,0 +1,30 @@
+use std::sync::Arc;
+
+use cluster_mode::ClusterMode;
+use itsi_error::Result;
+use single_mode::SingleMode;
+
+pub mod cluster_mode;
+pub mod single_mode;
+
+#[derive(Clone)]
+pub(crate) enum ServeStrategy {
+    Single(Arc<SingleMode>),
+    Cluster(Arc<ClusterMode>),
+}
+
+impl ServeStrategy {
+    pub fn run(self) -> Result<()> {
+        match self {
+            ServeStrategy::Single(single_router) => single_router.run(),
+            ServeStrategy::Cluster(cluster_router) => cluster_router.run(),
+        }
+    }
+
+    pub(crate) fn stop(&self) -> Result<()> {
+        match self {
+            ServeStrategy::Single(single_router) => single_router.stop(),
+            ServeStrategy::Cluster(cluster_router) => cluster_router.stop(),
+        }
+    }
+}