まだマイクロサービスにしない — モノリスと12 Factor

モノリスと12 Factor。一つのまとまったアプリの箱、内部の部品と点検リスト。

分けるべきかどうかは、規模ではなく困りごとで決まります。12 Factor Appを基準に、いま分けなくてよい理由を確かめます。

前回: キャッシュは4箇所にある — Cache-ControlとCDN 作業場所はVMの中(Ubuntu Server)です。ここまでで作った ~/server(Express + MySQL + Redis)が、myserver@3000 と myserver@3001 の2つで動いている状態から始めます。

ここまで来ると、たいてい同じ不安が出てきます。

「自分のアプリは1個のファイルに全部入っている。これはマズいのでは?」

検索すると、そう思わせる記事がいくらでも出てきます。モノリスは古い、マイクロサービスが現代的だ、Netflix はこうしている、と。

この記事の結論を、先に書きます。

個人が作っているサービスは、モノリスで正しい。 分けるのは、困ってからでいい。

これは「まだ早いから我慢しよう」という話ではありません。分けること自体が、確実に仕事を増やすからです。しかもその増えた仕事は、ここまでの回で私たちがすでに苦労してきたものと同じ種類です。

マイクロサービスは、この3つを全部、同時に、難しくします。

ですから、この回でやるのは「分け方」ではありません。

いま自分が作ったものを点検して、「分けなくても大丈夫な状態」になっているかを確かめます。

その物差しとして 12 Factor App を使います。ただし12項目を暗記しません。 全部 ~/server に当てはめて、できている・怪しい・まだ関係ないの3つに仕分けます。そして1つだけ、できていなかったものを直します。

対象レベル: 中級 / 区分: 必修

目次

この記事でわかること

  • モノリスは失敗ではないこと。いま作ったものはモノリスで、それが正しい設計だということ
  • 分ける理由は「規模」ではなく「人」と「変更の速度」であること。1人なら分ける理由がほぼ無いこと
  • 分けた瞬間、関数呼び出しが「失敗しうる通信」になること。その差が実測で約1万倍あること
  • DBを分けるとトランザクションが効かなくなること。ロールバックを自分で書くことになること
  • 12 Factor App は暗記するものではなく、自分のアプリを採点する表だということ
  • ~/server はすでに大半を満たしていたこと。そして満たせていないのは「止め方」だったこと
  • モジュラーモノリスという中間があること。プロセスを分けずに境界だけ先に作れること

この記事でやること

  1. いま動いているものの形を確かめる(プロセス・ポート・依存先を、コマンドで数える)
  2. 同一プロセスの関数呼び出しと、localhost 越しのHTTPの往復時間を実測して比べる
  3. 12 Factor の12項目を ~/server に当てはめ、.env やログを実際に見て判定する
  4. 唯一できていなかった「停止時の後始末」を直す(この記事で手を動かすのはここだけ)
  5. app.js の行数を数えて、モジュラーモノリスに切り替える合図を決める

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
モノリス(monolith)1つのプログラムに機能が全部入っている形。 1枚岩。いまの ~/server がこれ
マイクロサービス機能ごとにプログラムを分けて、通信でつなぐ形。 別々に起動し、別々にデプロイする
モジュラーモノリス1つのプログラムのまま、中を境界のあるモジュールに分ける形。 今回すすめる中間案
12 Factor Appクラウドで動かすアプリが満たすべき12の性質をまとめたもの。2011年にHeroku社が公開した
ステートレスアプリが自分の中に状態を持たないこと。どのプロセスに当たっても同じ結果になる
グレースフルシャットダウン止めろと言われてから、処理中のものを終わらせて閉じること。いきなり死なない止まり方
SIGTERM「終わってください」とプロセスに送られる合図。 systemctl stop はまずこれを送る
サーキットブレーカー相手が壊れているとき、呼ぶのを一時的にやめる仕組み。呼び続けて共倒れするのを防ぐ
Saga(サーガ)DBが分かれてトランザクションが使えないとき、取り消し処理を自分で書いて帳尻を合わせるやり方
境界づけられたコンテキスト「この範囲では、この言葉はこの意味」と決めた区切り。 分ける線を引くときの単位

① いま作ったものは、モノリスです

まず、自分が何を作ったのかを言葉ではなく、コマンドで確かめます。

VMの中で打ちます。

bash
$ systemctl is-active myserver@3000 myserver@3001
$ sudo ss -tlnp | grep -E '3000|3001'
active
active
LISTEN 0  511  127.0.0.1:3000  0.0.0.0:*  users:(("node",pid=1502,fd=22))
LISTEN 0  511  127.0.0.1:3001  0.0.0.0:*  users:(("node",pid=1519,fd=22))

[スクリーンショット: 01_process_check.png] systemctl is-active と ss -tlnp を続けて実行し、2つのプロセスが別々のポートで待っているところを撮ってください。

ここで、大事な区別を1つします。

プロセスが2つある ≠ サービスが2つある。

この2つは、まったく同じ app.js を読んでいます。 負荷分散の回で、CPUを使い切るために同じものを複製しただけです。片方だけ機能が違う、ということはありません。

つまり——

いまの ~/server
コードの数1つ(app.js とその周辺)
デプロイの数1回(GitHub Actions が1本走れば全部が新しくなる)
プロセスの数2つ(複製)
DBの数1つ(appdb)

これが「モノリス」です。 そして、この形には名前の通りの利点があります。

モノリスの利点なぜ効くか
関数を呼ぶだけで済む通信が無い。失敗しない。速い(後で実測します)
トランザクションが効く1つのDBなので、BEGIN 〜 COMMIT がそのまま使える
ログが1か所journalctl -u myserver@3000 で全部読める
デプロイが1回バージョンの食い違いが起きない
手元で全部動くnode --env-file=.env app.js 1つで、機能が全部動く

これらは、全部あとで失うものです。 何を失うのかを知らずに分けると、失ってから気づきます。

1点だけ、正直に書きます。 ~/server には、実はもう「2つ目のプログラム」がいます。メッセージキューの回で書いた worker.js です。あれは別プロセスで、別に起動し、APIとはキュー越しにしか話しません。 あれが、この連載で作った一番小さい「サービス分割」でした。 ⑤で戻ってきます。


② 分けたくなるのは、どういうときか

「アクセスが増えたから分ける」ではありません。 負荷分散の回でやったとおり、アクセスが増えただけなら、同じものを複製すれば済みます。 それが一番安いからです。

分けたくなる理由は、実際には3つしかありません。

理由1: 人が増えた

一番多い理由が、これです。 そして技術的な理由ですらありません。

10人で1つのコードを触ると、こうなります。

  • 同じファイルを別々の人が直して、毎回コンフリクトする
  • AさんがリリースしたいのにBさんの作業が途中で、出せない
  • 誰かのバグで全部が落ちる

分けると、これが消えます。 チームごとに自分のコードを、自分の都合でリリースできます。

逆に言うと、1人なら、この利点は1つも手に入りません。 コンフリクトする相手がいないからです。マイクロサービスは組織の問題への回答であって、性能の話ではありません。

理由2: 一部だけ、極端に負荷が高い

全体は暇なのに、1つの機能だけがCPUを食い潰す場合です。

たとえば「画像を変換する処理」だけが重いとき、モノリスのまま台数を増やすと、使っていないログイン処理やタスク一覧も一緒に10個に増えます。 メモリの無駄です。

そこだけ切り出せば、そこだけ10個にできます。

ただし、順番があります。 パフォーマンス改善の回でやったとおり、まず測ります。 「重そうだから」で切り出すと、切り出した先が暇だったという結果になります。

理由3: 一部だけ、違う技術を使いたい

画像処理は Python の方が道具が揃っている。 集計は別の言語の方が速い。 こういうとき、その部分だけ別の言語で書いて、通信でつなぐのは筋の通った理由です。


そして、この3つのどれにも当てはまらないなら、分ける理由はありません。

いま ~/server を触っているのは1人です。負荷は測った結果、CPUが先に詰まりました。言語を変えたい部分もありません。

「将来のために先に分けておく」は、一番よくある失敗です。 将来どこで切るべきかは、いま分かりません。 間違った場所で切ると、その線をまたぐ変更のたびに、2つのサービスを同時に直すことになります。分けたのに、いつも一緒に直す——これが最悪の形です。


③ 分けると増える仕事

ここが本題です。4つあります。 そして4つとも、この連載ですでに味わったものです。

(1) 関数呼び出しが、失敗しうる通信になる

モノリスでは、こう書いていました。

const user = findUser(id);

分けると、こうなります。

const res = await fetch(`http://user-service:3000/users/${id}`);

見た目は似ています。中身は別物です。

関数呼び出しHTTP呼び出し
失敗するかしない(例外は自分のコードのバグ)する。 相手が落ちている・遅い・ネットワークが切れた
時間ほぼゼロ通信ぶんかかる
書く量1行タイムアウト・リトライ・失敗時の扱い

「ほぼゼロ」と「通信ぶん」が、どれくらい違うのか。 言葉で納得しても仕方ないので、測ります。

VMの中で、~/server で打ちます。

bash
$ cd ~/server
$ node -e 'function findUser(i){return {id:i};} const t0=process.hrtime.bigint(); for(let i=0;i<200;i++){findUser(i);} const t1=process.hrtime.bigint(); console.log("関数呼び出し 200回:", Number(t1-t0)/1e6, "ms");'
関数呼び出し 200回: 0.021 ms

次に、同じ回数だけ localhost にHTTPを投げます。 呼び先は負荷分散の回で作った /api/health です。ログイン不要で即答する出口なので、そのまま使えます。

bash
$ cd ~/server
$ node -e 'const http=require("http"); let n=0; const t0=Date.now(); (function hit(){ if(n++>=200){ console.log("HTTP 200回:", Date.now()-t0, "ms"); return; } http.get("http://127.0.0.1:3000/api/health", r=>{ r.resume(); r.on("end", hit); }); })();'
HTTP 200回: 268 ms

[スクリーンショット: 02_call_cost.png] 上の2つのコマンドを続けて実行し、0.0xx ms と 2xx ms が並んでいるところを撮ってください。数字は環境で違って構いません。

この記事の実機では、約1万倍でした。

そしてこれは、一番条件の良い測り方です。

  • 同じマシンの中(127.0.0.1)。ネットワークカードもスイッチも通っていません
  • 相手は生きていて、暇です
  • 1件ずつ順番なので、混雑もありません

本当に別のサーバーに置いたら、ここに数ミリ秒が乗ります。 そして相手が落ちていれば、タイムアウトまで待たされます。

これは「マイクロサービスは遅いからダメ」という話ではありません。 1回2ミリ秒なら、たいてい問題になりません。問題になるのは、1つの画面を作るのに5回呼ぶときです。 5回×2ミリ秒で10ミリ秒——ではなく、5回のうち1回でも失敗したら、その画面は出ません。 足し算ではなく、掛け算で壊れやすくなります。

(2) トランザクションが効かなくなる

トランザクションの回で手に入れたのは、これでした。

全部やるか、1つもやらないか。

DBを分けた瞬間、これが成立しなくなります。

「注文サービス」と「在庫サービス」がそれぞれ自分のDBを持っているとします。

  1. 注文サービスが、自分のDBに注文を書く → 成功
  2. 在庫サービスに「1つ減らして」とHTTPで頼む → タイムアウト

このとき、ROLLBACK は打てません。 相手は別のDBで、そもそも減ったのかどうかも分かりません(返事が来ないのは「届かなかった」とは違います)。

やることになるのは、これです。

  • 取り消し用の処理を、自分で書く(注文を「キャンセル済み」にするAPIを作る)
  • どこまで進んだかを、自分で記録する
  • 2回頼まれても1回ぶんにする(キューの回でやった冪等が、ここでも必須になります)

これが Saga と呼ばれるものです。DBが1つならタダで手に入っていた性質を、コードで書き直す作業だと思ってください。

(3) ログとトレースが分断される

分散トレーシングの回で見たとおりです。

あの回で私は、こう書きました。

サーバーが2つに増えたら、繋がらない。 A の 260ms のうち 200ms が B だった、が見えない。

1台のときは、console.time を手で挟むだけで足りました。 分けた瞬間、それが足りなくなります。

分けると必要になるもの何をする道具か
ログの集約3か所に散ったログを1画面にする。分けた数だけ散る
分散トレーシング1本のリクエストが、どのサービスで何ミリ秒使ったかを繋ぐ
監視サービスの数だけ、監視対象が増える

つまり、あの2回でやったことは「マイクロサービスの前払い」でした。 逆に言えば、あれを入れずに分けると、壊れたときに何も分かりません。

(4) デプロイと運用が、数だけ増える

サービスを3つに分けると、3倍になるものがあります。

  • CI/CD のワークフローが3本(GitHub Actions の設定が3つ)
  • .env が3つ(同じDBパスワードを3か所で管理する)
  • 起動の仕組みが3つ(systemd なら service ファイルが3つ、コンテナなら Compose の定義が3つ)
  • バージョンの組み合わせが増える(Aの新版とBの旧版が同時に動く時間が必ずある)

そして、ここで Kubernetes が出てきます。 「サービスが増えたから、まとめて面倒を見るものが要る」からです。3台クラスタの回で味わったとおり、それ自体が学習コストと運用コストの塊です。

順番が逆になっている記事が多いので、はっきり書きます。 Kubernetes があるからマイクロサービスにするのではありません。 マイクロサービスにしたから Kubernetes が要るのです。 分けなければ、要りません。


④ 12 Factor App を、自分のアプリの点検表にする

では、モノリスのままで何をしておけばいいのか。

答えは 「分けられる状態にしておく」 です。そして、その物差しとして使えるのが 12 Factor App です。

12 Factor は、マイクロサービスの作り方ではありません。 2011年に Heroku 社が公開した、「クラウドで動かすアプリが満たしていると幸せな12の性質」です。モノリスにもそのまま当てはまります。

ここからは、12項目を読み上げません。 全部 ~/server に当てはめて、3つに仕分けます。

すでにできている7つ(そして、いつできたか)

性質~/server の状態いつやったか
コードは1リポジトリ、デプロイは複数~/server が1つの Git リポジトリ。そこから3000番と3001番の2つが動いているGitHubに上げた回
依存を明示するpackage.json と package-lock.json があり、npm ci で固定して入るCI/CDの回
設定を環境変数で外に出すDBのパスワードもセッションの秘密も .env。コードに直書きしていない認証の回
プロセスはステートレスセッションはアプリのメモリではなく Redis にある負荷分散の回
自分でポートを持つapp.listen(PORT, "127.0.0.1")。Apacheのモジュールとしてではなく、単体で待つサーバーを手で書いた回
プロセスを増やして捌くmyserver@3000 と myserver@3001。スレッドではなくプロセスを足した負荷分散の回
管理作業も同じコードでマイグレーションは knex migrate:latest。手でSQLを打っていないORMの回

この表を見て、気づいてほしいことがあります。

12 Factor を意識してやったことは、1つもありません。 困って直したら、結果的にそうなっていました。

セッションを Redis に出したのは、ログインが壊れたからです。 .env に出したのは、パスワードをGitに上げたくなかったからです。 12 Factor は、先に読むルールブックではなく、後から答え合わせをする表として使うのが正しいと思っています。

コマンドで、実際に確かめる

表を眺めるだけでは点検になりません。 3つだけ、実際に確認します。

(1)設定は本当に外に出ているか。

.env の中身は絶対に画面に出しません。 セキュリティ点検の回で書いたとおり、ターミナルの履歴とスクリーンショットに残ります。 キーの名前だけを出します。

bash
$ grep -oE '^[A-Z_]+' ~/server/.env
DB_HOST
DB_USER
DB_PASSWORD
DB_NAME
SESSION_SECRET

次に、コードの側に直書きが残っていないかを見ます。

bash
$ grep -nE 'password|secret' ~/server/app.js
14:  password: process.env.DB_PASSWORD,
31:    secret: process.env.SESSION_SECRET,

process.env. が付いていれば合格です。 ここに文字列が直接書いてあったら、そこが直す場所です。

(2)ステートレスになっているか。

bash
$ grep -n "RedisStore\|connect-redis" ~/server/app.js

行が出れば、セッションはアプリの外にあります。 何も出なければ、アプリのメモリに入っています(=プロセスを増やした瞬間にログインが切れます)。

もう1つ、見落としやすい場所があります。

bash
$ ls ~/server/uploads 2>/dev/null || echo "アップロード先のフォルダは無い"

アプリがローカルのフォルダにファイルを保存していると、そのファイルは「そのプロセスの中だけ」にあります。 3000番で受け取った画像は、3001番からは見えません。ここも「アプリの外に出す」対象です(今回は作っていないので該当しません)。

(3)ログはどこへ行っているか。

bash
$ grep -n "createWriteStream\|access.log" ~/server/app.js || echo "自分でログファイルを書いていない"
$ journalctl -u myserver@3000 -n 5 --no-pager

console.log で標準出力に出すだけにしておくと、受け取る側を後から差し替えられます。 いまは systemd が受け取り、Promtail が Loki に送っています。アプリはそれを知りません。それが正解です。

12 Factor の「ログ」の項目を、私は最初「ログを出すな」と読み違えました。 違います。 出すのはやめません。「どこに置くか」をアプリが決めるな、という話です。ファイル名もローテーションも、アプリの外の仕事です。

怪しい3つ

性質~/server の状態判定
バックエンドサービスは差し替え可能な付属品MySQL も Redis も .env のホスト名で指している。が、どちらも localhost 固定で、別マシンに移したことは無い△
ビルド・リリース・実行を分けるCI は同じディレクトリで git pull → npm ci → restart。「リリース」という単位が残っていない△
すばやく起動し、行儀よく終了する起動は速い。終了は、いきなり殺されている✕

上の2つは、いま直す必要はありません。 どちらも「1台しかないから困っていない」だけで、困る場面が来たら直せば済みます(前者は .env を書き換えるだけ、後者はTerraformやGitOpsで扱った「作り直せること」の話です)。

3つ目だけ、いま直します。

まだ関係ない2つ

性質なぜ関係ないか
開発環境と本番環境を揃える同じVMの中で開発して、同じVMで動かしています。 差が無いので、いまは満たしています。本番を別に立てた日に、初めて課題になります
すべてのプロセスを対等に扱うプロセスの種類は1つ(worker.js を動かしているときだけ2つ)。分ける対象がまだありません

「まだ関係ない」を「できていない」と書かないでください。 12項目を全部満たすことは目的ではありません。 満たしていない理由を説明できることが目的です。


できていなかった1つを直す —— 止め方

確認します。VMの中です。

bash
$ grep -n "SIGTERM" ~/server/app.js || echo "SIGTERM を受けていない"
SIGTERM を受けていない

何が起きているか。

sudo systemctl restart myserver@3000 を打つと、systemd はまず SIGTERM(終わってください) を送ります。いまの app.js はこれを受け取る用意が無いので、Node.js の既定の動作で即座に終了します。

そのとき、処理中のリクエストがあったら、どうなるか。

返事を待っている人の接続が、途中で切れます。

1人で触っているうちは気づきません。 負荷分散の回でやったようにnginx が2つに振り分けている状態でデプロイすると、再起動した側に当たった人だけがエラーになります。

直します。

bash
$ nano ~/server/app.js

一番下の app.listen を、こう書き換えます。 app.listen はサーバーのオブジェクトを返しているので、それを受け取るのが要点です。

const server = app.listen(PORT, "127.0.0.1", () => {
  console.log(`instance=${INSTANCE} listening on 127.0.0.1:${PORT}`);
});

process.on("SIGTERM", () => {
  console.log("SIGTERM: 新しい接続の受付をやめます");
  server.closeIdleConnections?.();
  server.close(() => {
    console.log("処理中のリクエストが終わりました。終了します");
    process.exit(0);
  });
  setTimeout(() => {
    console.error("10秒待っても閉じないので、強制終了します");
    process.exit(1);
  }, 10000).unref();
});
書いたもの意味
const server =app.listen の戻り値。これが無いと close() を呼べません
server.close(cb)新しい接続を受けるのをやめ、処理中が全部終わったらコールバックを呼ぶ
closeIdleConnections()何もしていない接続を先に切る(後述。Node.js 18 以前では、これが無いと待たされます)
setTimeout(...).unref()10秒経っても終わらなければ諦める保険。 unref() は「このタイマーのせいでプロセスが生き残らないように」の意味

反映して、確かめます。

bash
$ sudo systemctl restart myserver@3000
$ journalctl -u myserver@3000 -n 10 --no-pager
SIGTERM: 新しい接続の受付をやめます
処理中のリクエストが終わりました。終了します
instance=3000 listening on 127.0.0.1:3000

[スクリーンショット: 03_sigterm_log.png] journalctl に SIGTERM: の行と、その下に再起動後の listening on の行が並んでいるところを撮ってください。

戻したいときは、process.on("SIGTERM", ...) のブロックを丸ごと消して const server = を app.listen( に戻し、sudo systemctl restart myserver@3000 を打てば元通りです。

これが「分けられる状態」に一歩近づいた、ということです。 サービスが増えれば、再起動の回数も増えます。 止まり方が雑なアプリを10個並べると、デプロイのたびに10回エラーが出ます。


⑤ 分けるなら、どこで切るか

それでも分ける日が来たときのために、線の引き方だけ書いておきます。 引き方は2つです。

データで切る

1つのサービスが、1つのデータの塊を持つ。他のサービスは、そのテーブルに直接触らない。

これが本命です。 そして一番よく破られるルールでもあります。

「注文サービス」と「在庫サービス」に分けたのに、注文サービスが在庫テーブルに直接 SELECT を打っている——これをやると、分けた意味が完全に消えます。 在庫側がテーブルの形を変えた瞬間に、注文側が壊れるからです。プロセスは2つ、実体は1つという一番悪い状態です。

判定は簡単です。

相手のテーブルを、自分のSQLに書いていないか。

機能で切る

「注文」「在庫」ではなく、「画像を変換する」「メールを送る」のような作業単位で切るやり方です。こちらの方が、個人には現実的です。 理由は、すでに1回やっているからです。

キューを挟むと、切り口が変わる

メッセージキューの回で作った worker.js を思い出してください。

HTTPで呼ぶキューを挟む
相手が落ちていたらその場で失敗する。 呼んだ側がエラーを返すキューに溜まる。 相手が起きたら処理される
呼んだ側は返事を待つ待たない。 投げたら終わり
必要になるものタイムアウト・リトライ・サーキットブレーカー冪等(同じメッセージが2回来る)

③の(1)で書いた「失敗しうる通信」という問題の、半分がここで消えます。 相手が生きているかを気にしなくてよくなるからです。

だから、最初に切り出すべきなのは「返事が要らない仕事」です。 画像変換・メール送信・レポート生成。worker.js がまさにそれでした。 返事が要る仕事を切り出すのは、その次です。

そして、この時点でも worker.js はDBを共有しています。 それでいいと思っています。 分割は0か1ではありません。「プロセスは分けた、DBはまだ1つ」は、ちゃんとした中間地点です。


⑥ モジュラーモノリス —— 分けずに、境界だけ作る

「分けない」と「分ける」の間に、もう1つあります。

プロセスは1つのまま。中を、境界のあるモジュールに分ける。

まず、いまの大きさを数えます。

bash
$ wc -l ~/server/app.js
214 ~/server/app.js

214行なら、まだ何もしなくていいと思っています。 全部が1画面に近く、目で追えるからです。

私は、自分の合図をこう決めました。

状態やること
300行くらいまで1ファイルのまま。 分けるほうが読みにくい
300行を超えたらroutes/ に機能ごとに分ける(routes/tasks.js、routes/users.js)
人が増えたらそのときに初めて、プロセスを分ける話をする

フォルダで分けるときのルールは、1つだけです。

他のモジュールのテーブルを、直接触らない。

routes/tasks.js が users テーブルに SELECT を打ちたくなったら、users 側が用意した関数を呼びます。 これは⑤で書いた「データで切る」と、まったく同じルールです。

このルールを守ったモノリスは、そのまま切り出せます。 守っていないモノリスは、切り出そうとした日に、全部書き直しになります。

つまり、モジュラーモノリスは「マイクロサービスの練習」ではありません。 境界を先に引いておいて、分けるかどうかの判断を後回しにできる状態のことです。そして大半の場合、後回しにしたまま終わります。それでいいのです。


つまずいたところ

1. SIGTERM を足したのに、再起動が10秒かかった

最初、closeIdleConnections() を書いていませんでした。 結果、server.close() のコールバックがいつまでも呼ばれず、10秒後の強制終了に毎回落ちました。

10秒待っても閉じないので、強制終了します

原因は Keep-Alive でした。 ブラウザや nginx は、次のリクエストのために接続を開けたままにしています。server.close() は、Node.js 18 以前では「開いている接続が全部閉じるまで」待つので、何もしていない接続に待たされていたわけです。 Node.js 19 以降の server.close() は、何もしていない接続を自分で閉じるので、この待ちは起きません。

server.closeIdleConnections() は、処理中でない接続だけを先に切ります。 これを入れたら、再起動が一瞬になりました。

?. を付けているのは、古い Node.js にこの関数が無いためです。 無ければ何もせず飛ばします。

2. .env の中身を、うっかり cat した

点検のとき、最初に cat ~/server/.env と打ちました。DBのパスワードとセッションの秘密が、そのまま画面に出ました。

打ってしまったら、履歴に残ります。

bash
$ history | tail -5

この記事では grep -oE '^[A-Z_]+' で、キーの名前だけを出す形に直しました。 セキュリティ点検の回に書いた「秘密は、見る前に見ない方法を考える」を、自分で破りかけました。

3. 「マイクロサービスは小さいほど良い」と思って、worker.js を2つに割ろうとした

画像変換とメール送信を別のプログラムにしようとしました。 そこで手が止まりました。

  • どちらも同じDBを見ている
  • どちらも同じ .env を読む
  • どちらも同じキューから取っている

分けても、増えるのは systemd の設定ファイルとデプロイ手順だけでした。「分けたい理由」が、②の3つのどれでもなかったからです。やめました。

4. 12 Factor を上から順に「実装しよう」として、手が止まった

最初、12項目を上から読んで、1つずつ対応しようとしました。 3つ目の「設定」で気づきました。

もう終わっている。

やるべきだったのは、実装ではなく採点でした。 できているものに丸を付けて、できていないものだけ直す。 ④の形に書き直したのは、そのあとです。


まとめ

  • モノリスは古い形ではない。 1つのプログラムに全部入っているのは、いまの ~/server の正しい姿
  • プロセスが2つある ≠ サービスが2つある。 3000番と3001番は同じコードの複製で、これはモノリスのまま
  • 分ける理由は3つだけ。 人が増えた / 一部だけ負荷が高い / 一部だけ技術を変えたい。アクセスが増えたは理由にならない(複製で済む)
  • マイクロサービスは、組織の問題への回答。 1人で作っているなら、利点をほぼ1つも受け取れない
  • 分けると、関数呼び出しが「失敗しうる通信」になる。 実測で同じマシンの中でも約1万倍(0.02ms 対 268ms / 200回)
  • DBを分けるとトランザクションが効かない。 ROLLBACK の代わりに、取り消し処理を自分で書くことになる
  • ログもトレースも分断される。 集約とトレーシングは、分ける前に払う前払い
  • Kubernetes があるから分けるのではない。分けたから要るようになる。 順番を逆にしない
  • 12 Factor は暗記するものではなく、後から答え合わせをする採点表
  • ~/server は12項目のうち7つを、意識せずに満たしていた。 困って直した結果、そうなっていた
  • 満たせていなかったのは「止め方」。 SIGTERM を受けずに即死していた。server.close() で直した
  • closeIdleConnections() が無いと、Keep-Alive の接続に待たされて10秒かかる(Node.js 18 以前。19 以降は server.close() が自分で閉じる)
  • .env は cat しない。 キー名だけなら grep -oE '^[A-Z_]+'
  • 切るなら、まず「返事が要らない仕事」から。 キューを挟むと、相手が落ちていても壊れない
  • worker.js は、すでに一番小さいサービス分割だった。 DBは共有のまま。それでいい
  • モジュラーモノリスは中間案。 プロセスは1つのまま、他のモジュールのテーブルを直接触らないルールだけ守る
  • 結論: まず1つで作りきる。 困ってから分ける。 困っていないのに分けたものは、二度と1つに戻せない

参考リンク


次に読む

この記事は 【第8段階】深掘り の 6 / 30 本目です。

記事
← 前の記事キャッシュは4箇所にある — Cache-ControlとCDN
→ 次の記事速くする前に必ず測る — パフォーマンス改善とEXPLAIN

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Backend›Architectural Patterns
  • モノリスとマイクロサービス(分けると何が増えるか)
  • Twelve-Factor App を、自分のアプリの点検表にする

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次