分けるべきかどうかは、規模ではなく困りごとで決まります。12 Factor Appを基準に、いま分けなくてよい理由を確かめます。
前回: キャッシュは4箇所にある — Cache-ControlとCDN 作業場所はVMの中(Ubuntu Server)です。ここまでで作った
~/server(Express + MySQL + Redis)が、myserver@3000とmyserver@3001の2つで動いている状態から始めます。
ここまで来ると、たいてい同じ不安が出てきます。
「自分のアプリは1個のファイルに全部入っている。これはマズいのでは?」
検索すると、そう思わせる記事がいくらでも出てきます。モノリスは古い、マイクロサービスが現代的だ、Netflix はこうしている、と。
この記事の結論を、先に書きます。
個人が作っているサービスは、モノリスで正しい。 分けるのは、困ってからでいい。
これは「まだ早いから我慢しよう」という話ではありません。分けること自体が、確実に仕事を増やすからです。しかもその増えた仕事は、ここまでの回で私たちがすでに苦労してきたものと同じ種類です。
- 負荷分散の回で、アプリを2つにしたらログインが黙って壊れました
- トランザクションの回で、「全部やるか、1つもやらないか」を手に入れました
- 分散トレーシングの回で、1台でも「どこで時間を使ったか」が分からないことを見ました
マイクロサービスは、この3つを全部、同時に、難しくします。
ですから、この回でやるのは「分け方」ではありません。
いま自分が作ったものを点検して、「分けなくても大丈夫な状態」になっているかを確かめます。
その物差しとして 12 Factor App を使います。ただし12項目を暗記しません。 全部 ~/server に当てはめて、できている・怪しい・まだ関係ないの3つに仕分けます。そして1つだけ、できていなかったものを直します。
対象レベル: 中級 / 区分: 必修
この記事でわかること
- モノリスは失敗ではないこと。いま作ったものはモノリスで、それが正しい設計だということ
- 分ける理由は「規模」ではなく「人」と「変更の速度」であること。1人なら分ける理由がほぼ無いこと
- 分けた瞬間、関数呼び出しが「失敗しうる通信」になること。その差が実測で約1万倍あること
- DBを分けるとトランザクションが効かなくなること。ロールバックを自分で書くことになること
- 12 Factor App は暗記するものではなく、自分のアプリを採点する表だということ
~/serverはすでに大半を満たしていたこと。そして満たせていないのは「止め方」だったこと- モジュラーモノリスという中間があること。プロセスを分けずに境界だけ先に作れること
この記事でやること
- いま動いているものの形を確かめる(プロセス・ポート・依存先を、コマンドで数える)
- 同一プロセスの関数呼び出しと、localhost 越しのHTTPの往復時間を実測して比べる
- 12 Factor の12項目を
~/serverに当てはめ、.envやログを実際に見て判定する - 唯一できていなかった「停止時の後始末」を直す(この記事で手を動かすのはここだけ)
app.jsの行数を数えて、モジュラーモノリスに切り替える合図を決める
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| モノリス(monolith) | 1つのプログラムに機能が全部入っている形。 1枚岩。いまの ~/server がこれ |
| マイクロサービス | 機能ごとにプログラムを分けて、通信でつなぐ形。 別々に起動し、別々にデプロイする |
| モジュラーモノリス | 1つのプログラムのまま、中を境界のあるモジュールに分ける形。 今回すすめる中間案 |
| 12 Factor App | クラウドで動かすアプリが満たすべき12の性質をまとめたもの。2011年にHeroku社が公開した |
| ステートレス | アプリが自分の中に状態を持たないこと。どのプロセスに当たっても同じ結果になる |
| グレースフルシャットダウン | 止めろと言われてから、処理中のものを終わらせて閉じること。いきなり死なない止まり方 |
SIGTERM | 「終わってください」とプロセスに送られる合図。 systemctl stop はまずこれを送る |
| サーキットブレーカー | 相手が壊れているとき、呼ぶのを一時的にやめる仕組み。呼び続けて共倒れするのを防ぐ |
| Saga(サーガ) | DBが分かれてトランザクションが使えないとき、取り消し処理を自分で書いて帳尻を合わせるやり方 |
| 境界づけられたコンテキスト | 「この範囲では、この言葉はこの意味」と決めた区切り。 分ける線を引くときの単位 |
① いま作ったものは、モノリスです
まず、自分が何を作ったのかを言葉ではなく、コマンドで確かめます。
VMの中で打ちます。
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 で打ちます。
関数呼び出し 200回: 0.021 ms
次に、同じ回数だけ localhost にHTTPを投げます。 呼び先は負荷分散の回で作った /api/health です。ログイン不要で即答する出口なので、そのまま使えます。
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を持っているとします。
- 注文サービスが、自分のDBに注文を書く → 成功
- 在庫サービスに「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 の中身は絶対に画面に出しません。 セキュリティ点検の回で書いたとおり、ターミナルの履歴とスクリーンショットに残ります。 キーの名前だけを出します。
DB_HOST
DB_USER
DB_PASSWORD
DB_NAME
SESSION_SECRET
次に、コードの側に直書きが残っていないかを見ます。
14: password: process.env.DB_PASSWORD,
31: secret: process.env.SESSION_SECRET,
process.env. が付いていれば合格です。 ここに文字列が直接書いてあったら、そこが直す場所です。
(2)ステートレスになっているか。
行が出れば、セッションはアプリの外にあります。 何も出なければ、アプリのメモリに入っています(=プロセスを増やした瞬間にログインが切れます)。
もう1つ、見落としやすい場所があります。
アプリがローカルのフォルダにファイルを保存していると、そのファイルは「そのプロセスの中だけ」にあります。 3000番で受け取った画像は、3001番からは見えません。ここも「アプリの外に出す」対象です(今回は作っていないので該当しません)。
(3)ログはどこへ行っているか。
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の中です。
SIGTERM を受けていない
何が起きているか。
sudo systemctl restart myserver@3000 を打つと、systemd はまず SIGTERM(終わってください) を送ります。いまの app.js はこれを受け取る用意が無いので、Node.js の既定の動作で即座に終了します。
そのとき、処理中のリクエストがあったら、どうなるか。
返事を待っている人の接続が、途中で切れます。
1人で触っているうちは気づきません。 負荷分散の回でやったようにnginx が2つに振り分けている状態でデプロイすると、再起動した側に当たった人だけがエラーになります。
直します。
一番下の 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() は「このタイマーのせいでプロセスが生き残らないように」の意味 |
反映して、確かめます。
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つのまま。中を、境界のあるモジュールに分ける。
まず、いまの大きさを数えます。
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のパスワードとセッションの秘密が、そのまま画面に出ました。
打ってしまったら、履歴に残ります。
この記事では 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つに戻せない
参考リンク
- roadmap.sh — System Design
- roadmap.sh — Backend
- The Twelve-Factor App(日本語)
- The Twelve-Factor App(原文)
- Martin Fowler — MonolithFirst
- Martin Fowler — Microservice Premium
- Martin Fowler — Microservices
- microservices.io — Saga パターン
- microservices.io — Database per service
- Node.js —
server.close - Node.js —
server.closeIdleConnections - Express — Production Best Practices: Performance and Reliability
- systemd.kill — 停止時に送る合図の設定
次に読む
この記事は 【第8段階】深掘り の 6 / 30 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- モノリスとマイクロサービス(分けると何が増えるか)
- Twelve-Factor App を、自分のアプリの点検表にする
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント