From 64ac94a571ef4e064dba07628126dfe415c591b7 Mon Sep 17 00:00:00 2001 From: itsumura-h Date: Tue, 31 Mar 2026 06:29:12 +0000 Subject: [PATCH 1/7] refactor(benchmark): remove unused settings and Postgres imports; localize std/cpuinfo import to release branch for maxConnections --- .../FrameworkBenchmarks/basolato/config/database.nim | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/examples/benchmark/FrameworkBenchmarks/basolato/config/database.nim b/examples/benchmark/FrameworkBenchmarks/basolato/config/database.nim index 0e91fcdd..e63f339e 100644 --- a/examples/benchmark/FrameworkBenchmarks/basolato/config/database.nim +++ b/examples/benchmark/FrameworkBenchmarks/basolato/config/database.nim @@ -1,12 +1,9 @@ -import basolato/settings -import db_connector/db_postgres import allographer/connection -when defined(release): - import std/cpuinfo let maxConnections = when defined(release): + import std/cpuinfo (2000 div countProcessors()) - 2 else: 95 From fc051566f274c68bbc88f3e320ba0104b3f33bfa Mon Sep 17 00:00:00 2001 From: itsumura-h Date: Tue, 31 Mar 2026 08:55:44 +0000 Subject: [PATCH 2/7] Investigate and apply Nim build optimizations: add benchmarking script and update production build flags. Remove stack/line trace from production builds in buildImpl, add scripts/bench_ducere_build_opts.sh for measuring compile time/size/perf, update docs (en/ja) to document production flags, adjust benchmark Dockerfile to use speed optimizations, and tweak example DB config. --- .cursor/rules/branch/fix.mdc | 63 ++++++++++++------- documents/en/ducere.md | 2 + documents/ja/ducere.md | 2 + .../basolato/basolato.dockerfile | 2 +- .../basolato/config/database.nim | 4 +- scripts/bench_ducere_build_opts.sh | 60 ++++++++++++++++++ src/basolato/cli/functions/buildImpl.nim | 15 +---- 7 files changed, 110 insertions(+), 38 deletions(-) create mode 100755 scripts/bench_ducere_build_opts.sh diff --git a/.cursor/rules/branch/fix.mdc b/.cursor/rules/branch/fix.mdc index 1cadf914..f927af0f 100644 --- a/.cursor/rules/branch/fix.mdc +++ b/.cursor/rules/branch/fix.mdc @@ -6,30 +6,51 @@ fixブランチルール === このブランチで実装することは以下の通りです。 -- `ducere new` 実行時に、生成される新規プロジェクトが `examples/aaa` 配下と同じディレクトリ構造・ファイル構成になるように `src/basolato/cli/functions/newImpl.nim` を更新する -- 新規プロジェクト生成時のテンプレート取得を Git リポジトリの clone / download に依存しない方針へ置き換える -- 生成する `.nimble` ファイル名を CLI で渡された `packageDir` と同名にする +- `ducere build` が生成する Nim ビルドコマンドの最適化方針を見直す。 +- 候補となる Nim ビルドオプションを実際にコンパイルし、サンプルコードを使ってビルド時間・実行速度・生成物サイズを計測する。 +- 計測結果を根拠に、`/application/src/basolato/cli/functions/buildImpl.nim` の本番ビルドオプションを更新する。 +- 調査で得た知見が既存ドキュメントとずれる場合は、関連ドキュメントの補足や更新要否も整理する。 ## 進捗 -- [x] 現状調査: `examples/aaa` のディレクトリ構造と `src/basolato/cli/functions/newImpl.nim` の現在実装を確認した -- [x] `examples/aaa` から新規生成時に必要な最小ファイル群と、そのまま複製してよいファイル群を整理する -- [x] Git clone を廃止した場合のテンプレート同梱方法を決め、`newImpl.nim` の責務分割を設計する -- [x] `packageDir` を `.nimble` のファイル名と内容へ一貫して反映する実装方針を確定する -- [x] `newImpl.nim` を更新し、`examples/aaa` 相当の生成結果になることを確認する -- [x] `examples/aaa` の走査依存を除去し、ディレクトリとファイル内容を定数化したテンプレート生成へ切り替えた +- [x] 現在の `fix` ブランチ名とブランチルールファイルの対応を確認した。 +- [x] 現行の `/application/src/basolato/cli/functions/buildImpl.nim` における本番ビルドオプションを確認した。 +- [x] 計測対象とする Nim ビルドオプションの比較軸を確定する。 +- [x] ベンチマークに使うサンプルコードと計測手順を用意する（`examples/example`、`scripts/bench_ducere_build_opts.sh`）。 +- [x] 各ビルドオプションで複数回計測し、実行速度・ビルド時間・生成物サイズを比較する。 +- [x] 採用方針を決め、`/application/src/basolato/cli/functions/buildImpl.nim` に反映する。 +- [x] `ducere` ドキュメント（ja/en）に本番フラグの補足を追記した。 ## 参考資料 -- `examples/aaa` -- `src/basolato/cli/functions/newImpl.nim` -- `.cursor/rules/project.mdc` -- `.cursor/rules/branch.mdc` +- `/application/src/basolato/cli/functions/buildImpl.nim` +- `/application/src/basolato/cli/functions/serveImpl.nim` +- `/application/documents/ja/ducere.md` +- `/application/documents/en/ducere.md` +- `/application/runTest.sh` +- `/application/examples/benchmark/FrameworkBenchmarks/basolato/config/database.nim` +- `/application/examples/benchmark/web-frameworks/basolato/config.yaml` +- `/application/scripts/bench_ducere_build_opts.sh` ## 調査結果・設計まとめ -- 現在の `src/basolato/cli/functions/newImpl.nim` は `https://github.com/itsumura-h/nim-basolato-templates` を `git clone` し、`tmp/0.16` 配下の一部ディレクトリだけを移動する実装になっている -- この実装では `examples/aaa` に存在する `.env.example`、`app/README.md`、各種 `README.md`、`database/schema.nim`、`database/seeders`、`tests/test_sample.nim` などの初期ファイル群と完全には一致しない -- ユーザー要件として、今後は外部 Git リポジトリからテンプレートを取得せず、リポジトリ内に存在する雛形を元に新規プロジェクトを生成する必要がある -- 生成対象の正は `examples/aaa` とし、`aaa.nimble` のようにサンプル固有名を含むファイルは `packageDir.nimble` に置き換える前提で扱う -- 実装時は、サンプル固有値が残るファイルの有無を洗い出し、単純コピーで済むファイルと `packageDir` などの値を差し替えるファイルを分離して設計する -- `config.nims`、`.env`、`.env.example` はテンプレート複製ではなく `makeConfig(baseDir)` で生成し、それ以外のファイルは `examples/aaa` からローカル複製する方針にした -- `templateRoot` はカレントディレクトリ基準ではなく `currentSourcePath()` から上位へ探索して解決し、nimble install 後もパッケージ内の雛形を参照できるようにした -- 現在の最終方針は、`examples/aaa` を実行時に読むのではなく、`newImpl.nim` 内にディレクトリ一覧とファイル内容の文字列定数を持ち、CLI がディレクトリを作成してから各テンプレートを書き出す方式にすること +- 現状の本番ビルドでは `--threads:off`、`-d:ssl`、`-d:danger`、`-d:release`、`--parallelBuild:0`、`--passC:\"-flto\"`、`--passL:\"-flto\"`、`--panics:on` を付与している（2026-03 更新: `--stackTrace` / `--lineTrace` は計測の結果、本番から外す）。 +- `optimize=speed` は `--mm:markAndSweep -d:useRealtimeGC`、`optimize=memory` は `--mm:orc -d:useMalloc` を選ぶ実装のまま（CLI 互換維持）。 +- **コンパイル＋バイナリ（`examples/example`、`nim c -f` を3回の wall 時間平均、Nim 2.2.8 / Linux amd64）** + +| variant | avg compile (s) | bytes | +|---------|-----------------|-------| +| mem_danger_lto | 49.19 | 2380200 | +| speed_danger_lto | 48.43 | 2080824 | +| mem_danger_no_lto | 23.48 | 4848968 | +| speed_danger_no_lto | 17.03 | 2492344 | +| mem_nodanger_lto | 54.62 | 2654936 | +| speed_nodanger_lto | 51.74 | 2245248 | + +- **`-flto`**: リンクは遅延するが、特に ORC ではバイナリが極端に肥大化しやすいため本番では継続採用。 +- **`-d:danger`**: 同一 GC 設定内でコンパイル時間・サイズが有利な傾向。本番では継続採用。 +- **`--threads:on`**: 標準サーバ（`server.nim`）は `Async` の GC-safety エラーでビルド不能。`--threads:off` を維持。 +- **実行速度（`wrk -t2 -c20`、`/sample/fib/12`、markAndSweep 本番相当ビルド）**: `--stackTrace`/`--lineTrace` ありで約 1500 req/s、なしで約 2280 req/s（同一マシン・短時間計測）。本番からトレース用スイッチを外す判断とした。 +- **memory vs speed GC**: 同一エンドポイントでは markAndSweep+useRealtimeGC が orc+useMalloc より桁違いに高スループット（計測時は数百 vs 千台 req/s オーダー）。CPU 負荷が高い処理では `optimize=speed` を推奨。メモリ制約環境では `memory` の意味は維持。 +- 採用判断は「ビルドが通ること」を前提に、次の優先順位で行う。 +- 実行速度 +- 安定性と互換性 +- 生成バイナリサイズ +- 実装更新時は、CLI 引数 `optimize=speed|memory` の既存インターフェースを壊さない方針を第一候補とする。互換性を壊す場合は、理由をブランチルールに追記してから着手する。 diff --git a/documents/en/ducere.md b/documents/en/ducere.md index 88eedb6e..cf8a7eb1 100644 --- a/documents/en/ducere.md +++ b/documents/en/ducere.md @@ -174,6 +174,8 @@ ducere build --optimize=speed > nim c --mm:markAndSweep -d:useRealtimeGC ... main ``` +Production builds pass `-d:danger`, `-d:release`, `-d:ssl`, link-time optimization (`-flto`), and `--threads:off`. The default asynchttpserver-based stack does not compile with `--threads:on` today (GC-safety), so multi-threaded compilation is not supported there. `--stackTrace` / `--lineTrace` are omitted to favor runtime throughput and smaller binaries; invoke `nim c` yourself and add trace switches if you need rich production stack traces. `-flto` slows linking but usually shrinks the binary (without LTO, an ORC build of `examples/example` grew to several megabytes in our measurements). + ### database scripts Use these scripts when you want to apply migrations and seeders together. diff --git a/documents/ja/ducere.md b/documents/ja/ducere.md index 537be442..1a5c91b6 100644 --- a/documents/ja/ducere.md +++ b/documents/ja/ducere.md @@ -170,6 +170,8 @@ ducere build --optimize=speed > nim c --mm:markAndSweep -d:useRealtimeGC ... main ``` +本番ビルドでは `-d:danger`・`-d:release`・`-d:ssl`・リンク時最適化（`-flto`）、`--threads:off` を付与します。標準の asynchttpserver 系スタックは現状 `--threads:on` ではコンパイルできないため、スレッド有効化は想定していません。スタックトレース用の `--stackTrace` / `--lineTrace` は実行速度とバイナリサイズ優先のため付けません。本番で詳細なスタックが必要な場合は `nim c` を直接実行し、必要なトレース用スイッチを追加してください。`-flto` はリンクに時間がかかりますが、同一ソースではバイナリサイズの削減に効きます（`examples/example` での比較では LTO なし ORC ビルドが数 MB 規模で肥大化）。 + ### database scripts マイグレーションと seeder をまとめて実行したいときは、`database/` 配下のシェルスクリプトを使います。 diff --git a/examples/benchmark/FrameworkBenchmarks/basolato/basolato.dockerfile b/examples/benchmark/FrameworkBenchmarks/basolato/basolato.dockerfile index 5d2ae957..b89dc051 100644 --- a/examples/benchmark/FrameworkBenchmarks/basolato/basolato.dockerfile +++ b/examples/benchmark/FrameworkBenchmarks/basolato/basolato.dockerfile @@ -32,7 +32,7 @@ WORKDIR /basolato # Install dependencies only; avoid building this benchmark package via nimble. RUN nimble install -y -d -RUN ducere build -a --httpbeast +RUN ducere build -o:speed -a --httpbeast FROM ubuntu:24.04 AS runtime diff --git a/examples/benchmark/FrameworkBenchmarks/basolato/config/database.nim b/examples/benchmark/FrameworkBenchmarks/basolato/config/database.nim index e63f339e..18604d83 100644 --- a/examples/benchmark/FrameworkBenchmarks/basolato/config/database.nim +++ b/examples/benchmark/FrameworkBenchmarks/basolato/config/database.nim @@ -10,8 +10,8 @@ let maxConnections = let rdb* = dbopen( PostgreSQL, # SQLite3 or MySQL or MariaDB or PostgreSQL - url="postgresql://benchmarkdbuser:benchmarkdbpass@tfb-database:5432/hello_world", - # url="postgresql://user:pass@postgreDb:5432/database", + # url="postgresql://benchmarkdbuser:benchmarkdbpass@tfb-database:5432/hello_world", + url="postgresql://user:pass@postgreDb:5432/database", maxConnections=maxConnections, timeout=30, shouldDisplayLog=false, diff --git a/scripts/bench_ducere_build_opts.sh b/scripts/bench_ducere_build_opts.sh new file mode 100755 index 00000000..db0b831b --- /dev/null +++ b/scripts/bench_ducere_build_opts.sh @@ -0,0 +1,60 @@ +#!/usr/bin/env bash +# fixブランチ: ducere build 相当の Nim フラグ比較用（手動実行） +set -euo pipefail +ROOT="$(cd "$(dirname "$0")/.." && pwd)" +APP="$ROOT/examples/example" +OUTDIR="${TMPDIR:-/tmp}/basolato_build_bench" +mkdir -p "$OUTDIR" +cd "$APP" +export SECRET_KEY="${SECRET_KEY:-$(grep '^SECRET_KEY=' .env | cut -d= -f2- | tr -d '"')}" + +# buildImpl に揃えた共通フラグ（jsBuild 除く） +COMMON=( + --threads:off + -d:ssl + -d:release + --parallelBuild:0 + --panics:on +) + +elapsed_sec() { + local start end + start="$(date +%s.%N)" + "$@" + end="$(date +%s.%N)" + awk -v a="$start" -v b="$end" 'BEGIN{printf "%.3f", b-a}' +} + +run_variant() { + local name="$1" + shift + local out="$OUTDIR/$name" + local i t sum=0 + rm -f "$out" + for i in 1 2 3; do + rm -f "$out" + t="$(elapsed_sec nim c -f "${COMMON[@]}" "$@" --out:"$out" main.nim)" + sum="$(awk -v a="$sum" -v b="$t" 'BEGIN{printf "%.6f", a+b}')" + done + rm -f "$out" + nim c -f "${COMMON[@]}" "$@" --out:"$out" main.nim >/dev/null + local bytes + bytes="$(stat -c%s "$out" 2>/dev/null || stat -f%z "$out")" + echo "$name $(awk -v s="$sum" 'BEGIN{printf "%.3f", s/3}') $bytes" + rm -f "$out" +} + +echo "# Nim $(nim --version | head -1)" +echo "# cwd $APP" +echo "# 各設定: nim c -f を3回、表示は wall 秒の平均。最後に1回ビルドしてバイナリサイズ取得" +echo "variant avg_compile_sec_s bytes" + +# GC + 最適化軸 +run_variant "mem_danger_lto" --mm:orc -d:useMalloc -d:danger --passC:"-flto" --passL:"-flto" +run_variant "speed_danger_lto" --mm:markAndSweep -d:useRealtimeGC -d:danger --passC:"-flto" --passL:"-flto" +run_variant "mem_danger_no_lto" --mm:orc -d:useMalloc -d:danger +run_variant "speed_danger_no_lto" --mm:markAndSweep -d:useRealtimeGC -d:danger +run_variant "mem_nodanger_lto" --mm:orc -d:useMalloc --passC:"-flto" --passL:"-flto" +run_variant "speed_nodanger_lto" --mm:markAndSweep -d:useRealtimeGC --passC:"-flto" --passL:"-flto" + +# --threads:on は Basolato 標準サーバが GC-safety でコンパイル不能のため計測対象外 diff --git a/src/basolato/cli/functions/buildImpl.nim b/src/basolato/cli/functions/buildImpl.nim index 0c514544..3f2a0948 100644 --- a/src/basolato/cli/functions/buildImpl.nim +++ b/src/basolato/cli/functions/buildImpl.nim @@ -52,8 +52,6 @@ proc build*(workers:uint=0, force=false, httpbeast=false, httpx=false, autoResta --passC:"-flto" \ --passL:"-flto" \ --panics:on \ - --stackTrace \ - --lineTrace \ --out:{outputFileName} \ main.nim """ @@ -88,16 +86,5 @@ echo "running {workers} {processes}" #[ - ---threads:off \ ---threadAnalysis:off \ --d:ssl \ --d:release \ --d:danger \ ---checks:off \ --d:useMalloc \ --d:useRealtimeGC \ ---panics:on \ ---gc:orc \ - + Historical reference only; production flags are assembled in proc build above. ]# From 68516fa6de28429b33725360dcc36107a7eef5c6 Mon Sep 17 00:00:00 2001 From: itsumura-h Date: Tue, 31 Mar 2026 23:31:13 +0000 Subject: [PATCH 3/7] rm useMalloc --- src/basolato/cli/functions/buildImpl.nim | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/basolato/cli/functions/buildImpl.nim b/src/basolato/cli/functions/buildImpl.nim index 3f2a0948..4abeee5a 100644 --- a/src/basolato/cli/functions/buildImpl.nim +++ b/src/basolato/cli/functions/buildImpl.nim @@ -34,7 +34,7 @@ proc build*(workers:uint=0, force=false, httpbeast=false, httpx=false, autoResta if optimize == "speed": "--mm:markAndSweep -d:useRealtimeGC" else: - "--mm:orc -d:useMalloc" + "--mm:orc" if args.len > 0: outputFileName = args[0] From b4ce7fb81a46a136583b89f893bcb7a0e957c2cf Mon Sep 17 00:00:00 2001 From: itsumura-h Date: Wed, 1 Apr 2026 09:51:38 +0000 Subject: [PATCH 4/7] malloc option --- src/basolato/cli/functions/buildImpl.nim | 15 ++++----------- 1 file changed, 4 insertions(+), 11 deletions(-) diff --git a/src/basolato/cli/functions/buildImpl.nim b/src/basolato/cli/functions/buildImpl.nim index 4abeee5a..b710f4ba 100644 --- a/src/basolato/cli/functions/buildImpl.nim +++ b/src/basolato/cli/functions/buildImpl.nim @@ -19,22 +19,14 @@ proc jsBuild() = quit(QuitFailure) -const BUILD_HELP* = { - "optimize": "memory|speed" -}.toTable() - -proc build*(workers:uint=0, force=false, httpbeast=false, httpx=false, autoRestart=false, optimize="memory", args:seq[string]) = +proc build*(workers:uint=0, force=false, httpbeast=false, httpx=false, autoRestart=false, malloc=false, args:seq[string]) = ## Build for production. jsBuild() var outputFileName = "main" let fStr = if force: "-f" else: "" let serverStr = if httpbeast: "-d:httpbeast" elif httpx: "-d:httpx" else: "" + let mallocStr = if malloc: "-d:useMalloc" else: "" let workers = if workers == 0: countProcessors().uint else: workers - let optimize = - if optimize == "speed": - "--mm:markAndSweep -d:useRealtimeGC" - else: - "--mm:orc" if args.len > 0: outputFileName = args[0] @@ -43,7 +35,8 @@ proc build*(workers:uint=0, force=false, httpbeast=false, httpx=false, autoResta nim c \ {fStr} \ {serverStr} \ - {optimize} \ + {mallocStr} \ + --mm:orc \ --threads:off \ -d:ssl \ -d:danger \ From 81c62db0a6d68f8a9195778a802dc97f74b55eb8 Mon Sep 17 00:00:00 2001 From: itsumura-h Date: Wed, 1 Apr 2026 10:31:53 +0000 Subject: [PATCH 5/7] fix BUILD_HELP --- examples/benchmark/FrameworkBenchmarks/basolato/basolato.nimble | 2 +- src/basolato/cli/ducere.nim | 2 +- src/basolato/cli/functions/buildImpl.nim | 1 - 3 files changed, 2 insertions(+), 3 deletions(-) diff --git a/examples/benchmark/FrameworkBenchmarks/basolato/basolato.nimble b/examples/benchmark/FrameworkBenchmarks/basolato/basolato.nimble index 8a4b7779..3659f181 100644 --- a/examples/benchmark/FrameworkBenchmarks/basolato/basolato.nimble +++ b/examples/benchmark/FrameworkBenchmarks/basolato/basolato.nimble @@ -9,7 +9,7 @@ license = "MIT" # Dependencies requires "nim >= 2.0.0" -requires "https://github.com/itsumura-h/nim-basolato#main" +requires "https://github.com/itsumura-h/nim-basolato#fix" task test, "run testament": echo staticExec("testament p \"./tests/test_*.nim\"") diff --git a/src/basolato/cli/ducere.nim b/src/basolato/cli/ducere.nim index 6ba7ffbf..e2568b4e 100644 --- a/src/basolato/cli/ducere.nim +++ b/src/basolato/cli/ducere.nim @@ -7,4 +7,4 @@ import ./functions/buildImpl when isMainModule: import cligen clCfg.version = BasolatoVersion - dispatchMulti([newImpl.new], [make], [serve], [build, help=BUILD_HELP]) + dispatchMulti([newImpl.new], [make], [serve], [build]) diff --git a/src/basolato/cli/functions/buildImpl.nim b/src/basolato/cli/functions/buildImpl.nim index b710f4ba..33cc8792 100644 --- a/src/basolato/cli/functions/buildImpl.nim +++ b/src/basolato/cli/functions/buildImpl.nim @@ -2,7 +2,6 @@ import std/os import std/osproc import std/strformat import std/strutils -from std/tables import toTable proc jsBuild() = From 5d2f2c005073ca7b170691a73c3ec816d3cbb413 Mon Sep 17 00:00:00 2001 From: itsumura-h Date: Wed, 1 Apr 2026 13:06:19 +0000 Subject: [PATCH 6/7] . --- src/basolato/cli/functions/buildImpl.nim | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/src/basolato/cli/functions/buildImpl.nim b/src/basolato/cli/functions/buildImpl.nim index 33cc8792..dedd44b1 100644 --- a/src/basolato/cli/functions/buildImpl.nim +++ b/src/basolato/cli/functions/buildImpl.nim @@ -18,13 +18,12 @@ proc jsBuild() = quit(QuitFailure) -proc build*(workers:uint=0, force=false, httpbeast=false, httpx=false, autoRestart=false, malloc=false, args:seq[string]) = +proc build*(workers:uint=0, force=false, httpbeast=false, httpx=false, autoRestart=false, args:seq[string]) = ## Build for production. jsBuild() var outputFileName = "main" let fStr = if force: "-f" else: "" let serverStr = if httpbeast: "-d:httpbeast" elif httpx: "-d:httpx" else: "" - let mallocStr = if malloc: "-d:useMalloc" else: "" let workers = if workers == 0: countProcessors().uint else: workers if args.len > 0: @@ -34,7 +33,6 @@ proc build*(workers:uint=0, force=false, httpbeast=false, httpx=false, autoResta nim c \ {fStr} \ {serverStr} \ - {mallocStr} \ --mm:orc \ --threads:off \ -d:ssl \ From 5ef4f8dbd79f2cf722b18712295b8cd54b7842df Mon Sep 17 00:00:00 2001 From: itsumura-h Date: Wed, 1 Apr 2026 19:22:21 +0000 Subject: [PATCH 7/7] fix docs --- documents/en/ducere.md | 14 +------------- documents/ja/ducere.md | 14 +------------- 2 files changed, 2 insertions(+), 26 deletions(-) diff --git a/documents/en/ducere.md b/documents/en/ducere.md index cf8a7eb1..872903d9 100644 --- a/documents/en/ducere.md +++ b/documents/en/ducere.md @@ -106,7 +106,6 @@ Options: --httpbeast bool false set httpbeast --httpx bool false set httpx -a, --autoRestart bool false set autoRestart - -o=, --optimize= string "memory" memory|speed ``` By default, it will be compiled to run port 8000 with single-thread and multi-process settings. When you build application, shell script file named `startServer.sh` is generated. Run this file to start server. @@ -163,18 +162,7 @@ ducere build --httpbeast ducere build --httpx ``` -You can choose optimize option for memory or speed. -If memory is selected, `ORC` is used for less memory consumption. If speed is selected, markAndSweep is used for more throughput. - -```sh -ducere build --optimize=memory -> nim c --mm:orc -d:useMalloc ... main - -ducere build --optimize=speed -> nim c --mm:markAndSweep -d:useRealtimeGC ... main -``` - -Production builds pass `-d:danger`, `-d:release`, `-d:ssl`, link-time optimization (`-flto`), and `--threads:off`. The default asynchttpserver-based stack does not compile with `--threads:on` today (GC-safety), so multi-threaded compilation is not supported there. `--stackTrace` / `--lineTrace` are omitted to favor runtime throughput and smaller binaries; invoke `nim c` yourself and add trace switches if you need rich production stack traces. `-flto` slows linking but usually shrinks the binary (without LTO, an ORC build of `examples/example` grew to several megabytes in our measurements). +Production builds pass `-d:danger`, `-d:release`, `-d:ssl`, link-time optimization (`-flto`), `--mm:orc`, and `--threads:off`. The memory management strategy is unified to `ORC`, providing a well-balanced configuration for memory efficiency and stability. The default asynchttpserver-based stack does not compile with `--threads:on` today (GC-safety), so multi-threaded compilation is not supported. `--stackTrace` / `--lineTrace` are omitted to favor runtime throughput and smaller binaries; invoke `nim c` yourself and add trace switches if you need rich production stack traces. `-flto` slows linking but usually shrinks the binary (without LTO, an ORC build of `examples/example` grew to several megabytes in our measurements). ### database scripts Use these scripts when you want to apply migrations and seeders together. diff --git a/documents/ja/ducere.md b/documents/ja/ducere.md index 1a5c91b6..540fa8a2 100644 --- a/documents/ja/ducere.md +++ b/documents/ja/ducere.md @@ -102,7 +102,6 @@ Options: --httpbeast bool false set httpbeast --httpx bool false set httpx -a, --autoRestart bool false set autoRestart - -o=, --optimize= string "memory" memory|speed ``` 何もオプションを付けない場合、8000番ポートを使い、シングルスレッド・マルチプロセスで起動します。 ビルドすると`startServer.sh`というシェルスクリプトが作られるので、これを実行することでサーバーを起動します。 @@ -159,18 +158,7 @@ ducere build --httpbeast ducere build --httpx ``` -optimizeオプションにはmemoryかspeedを選択することができます。 -もしmemoryを選んだ時には `ORC` が使われ、メモリ消費が少なくなります。speedを選んだ時には `markAndSweep` が使われ、スループットがより多くなるようになります。 - -```sh -ducere build --optimize=memory -> nim c --mm:orc -d:useMalloc ... main - -ducere build --optimize=speed -> nim c --mm:markAndSweep -d:useRealtimeGC ... main -``` - -本番ビルドでは `-d:danger`・`-d:release`・`-d:ssl`・リンク時最適化（`-flto`）、`--threads:off` を付与します。標準の asynchttpserver 系スタックは現状 `--threads:on` ではコンパイルできないため、スレッド有効化は想定していません。スタックトレース用の `--stackTrace` / `--lineTrace` は実行速度とバイナリサイズ優先のため付けません。本番で詳細なスタックが必要な場合は `nim c` を直接実行し、必要なトレース用スイッチを追加してください。`-flto` はリンクに時間がかかりますが、同一ソースではバイナリサイズの削減に効きます（`examples/example` での比較では LTO なし ORC ビルドが数 MB 規模で肥大化）。 +本番ビルドでは `-d:danger`・`-d:release`・`-d:ssl`・リンク時最適化（`-flto`）、`--mm:orc`、`--threads:off` を付与します。メモリ管理方式は `ORC`に統一されており、メモリ効率と安定性のバランスが取れた設定となっています。標準の asynchttpserver 系スタックは現状 `--threads:on` ではコンパイルできないため、スレッド有効化は想定していません。スタックトレース用の `--stackTrace` / `--lineTrace` は実行速度とバイナリサイズ優先のため付けません。本番で詳細なスタックが必要な場合は `nim c` を直接実行し、必要なトレース用スイッチを追加してください。`-flto` はリンクに時間がかかりますが、同一ソースではバイナリサイズの削減に効きます（`examples/example` での比較では LTO なし ORC ビルドが数 MB 規模で肥大化）。 ### database scripts マイグレーションと seeder をまとめて実行したいときは、`database/` 配下のシェルスクリプトを使います。