From 906efff80fb3037086003b1f8ac7abeda0e226be Mon Sep 17 00:00:00 2001 From: Antoine Pierlot-Garcin Date: Tue, 10 Nov 2026 22:34:53 +0100 Subject: [PATCH] Image Docker du serveur et extraits de configuration MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Dockerfile en deux étapes pour le serveur relais, image finale distroless sans root. - README : extraits docker compose, Caddyfile et labels Traefik à ajouter à sa propre configuration. - Le serveur s'arrête proprement sur SIGTERM, pour que « docker stop » n'attende pas son délai. Co-Authored-By: Claude Fable 5.2 --- .dockerignore | 4 ++++ Cargo.lock | 11 +++++++++++ Dockerfile | 14 ++++++++++++++ README.md | 40 +++++++++++++++++++++++++++++++++++++++ crates/server/Cargo.toml | 2 +- crates/server/src/main.rs | 8 +++++++- 6 files changed, 77 insertions(+), 2 deletions(-) create mode 100644 .dockerignore create mode 100644 Dockerfile diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..7d2921f --- /dev/null +++ b/.dockerignore @@ -0,0 +1,4 @@ +target/ +.git/ +scripts/ +*.md diff --git a/Cargo.lock b/Cargo.lock index b174900..6a791bf 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -704,6 +704,16 @@ dependencies = [ "tokio-tungstenite", ] +[[package]] +name = "signal-hook-registry" +version = "1.4.8" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "c4db69cba1110affc0e9f7bcd48bbf87b3f4fc7c61fc9155afd4c469eb3d6c1b" +dependencies = [ + "errno", + "libc", +] + [[package]] name = "simd-adler32" version = "0.3.10" @@ -840,6 +850,7 @@ dependencies = [ "libc", "mio", "pin-project-lite", + "signal-hook-registry", "socket2", "tokio-macros", "windows-sys 0.61.2", diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..5450b1e --- /dev/null +++ b/Dockerfile @@ -0,0 +1,14 @@ +# Image du serveur relais show-me (le client, lui, tourne sur le bureau de chaque joueur). +FROM rust:1-bookworm AS build +WORKDIR /src +COPY . . +RUN --mount=type=cache,target=/usr/local/cargo/registry \ + --mount=type=cache,target=/src/target \ + cargo build --release --locked -p show-me-server \ + && cp target/release/show-me-server /show-me-server + +FROM gcr.io/distroless/cc-debian12:nonroot +COPY --from=build /show-me-server /usr/local/bin/show-me-server +EXPOSE 7878 +ENTRYPOINT ["/usr/local/bin/show-me-server"] +CMD ["--listen", "0.0.0.0:7878"] diff --git a/README.md b/README.md index b40f6e8..c718d49 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,46 @@ show-me-server --listen 127.0.0.1:7878 Le serveur parle WebSocket sans chiffrement : placez-le derrière un reverse proxy (Caddy, nginx) qui fournit le `wss://`. Il ne conserve rien ; le code du salon sert de secret partagé. +### Avec Docker + +Le `Dockerfile` à la racine construit une image du serveur seul, qui écoute sur le port 7878 : + +```bash +docker build -t show-me-server . +``` + +Extraits à ajouter à votre propre configuration, en remplaçant `show-me.example.org` par votre +domaine. Le service, dans votre `docker-compose.yml` : + +```yaml + show-me: + image: show-me-server + restart: unless-stopped +``` + +Avec **Caddy**, dans le même réseau Docker, ajoutez au `Caddyfile` : + +``` +show-me.example.org { + reverse_proxy show-me:7878 +} +``` + +Avec **Traefik**, ajoutez plutôt ces labels au service, en adaptant les noms du point d'entrée et +du résolveur de certificats aux vôtres : + +```yaml + labels: + - traefik.enable=true + - traefik.http.routers.show-me.rule=Host(`show-me.example.org`) + - traefik.http.routers.show-me.entrypoints=websecure + - traefik.http.routers.show-me.tls.certresolver=letsencrypt + - traefik.http.services.show-me.loadbalancer.server.port=7878 +``` + +Les deux relaient les WebSockets sans réglage particulier. Les clients se connectent ensuite à +`wss://show-me.example.org`. + ## Utilisation ```bash diff --git a/crates/server/Cargo.toml b/crates/server/Cargo.toml index 16af6dd..f2eac5f 100644 --- a/crates/server/Cargo.toml +++ b/crates/server/Cargo.toml @@ -9,5 +9,5 @@ clap = { version = "4.6.7", features = ["derive"] } futures-util = "0.3.34" serde_json = "1.0.154" show-me-protocol = { version = "0.1.0", path = "../protocol" } -tokio = { version = "1.54.1", features = ["rt-multi-thread", "macros", "net", "sync", "time"] } +tokio = { version = "1.54.1", features = ["rt-multi-thread", "macros", "net", "signal", "sync", "time"] } tokio-tungstenite = "0.30.0" diff --git a/crates/server/src/main.rs b/crates/server/src/main.rs index 77df7a4..b009933 100644 --- a/crates/server/src/main.rs +++ b/crates/server/src/main.rs @@ -66,8 +66,14 @@ async fn main() -> Result<()> { let listener = TcpListener::bind(args.listen).await.with_context(|| format!("écoute sur {}", args.listen))?; eprintln!("show-me-server écoute sur ws://{}", args.listen); let state = Arc::new(State { next_id: AtomicU32::new(1), ..Default::default() }); + // Arrêt propre sur SIGTERM (docker stop) ou Ctrl-C. + let mut sigterm = tokio::signal::unix::signal(tokio::signal::unix::SignalKind::terminate())?; loop { - let (stream, addr) = listener.accept().await?; + let (stream, addr) = tokio::select! { + accepted = listener.accept() => accepted?, + _ = sigterm.recv() => return Ok(()), + _ = tokio::signal::ctrl_c() => return Ok(()), + }; let state = state.clone(); tokio::spawn(async move { if let Err(e) = handle(stream, state).await {