-
システム設計
落ちても全部は止めない — サーキットブレーカと縮退
Redis を止めただけでページが真っ白になるのを、まず自分の手で再現します。次に、タイムアウトを書いていない外部呼び出しを1本足すだけで、DBの接続が10本とも埋まり、関係ないAPIまで巻き添えで死ぬところ(カスケード障害)を実演します。そこから、一番効くタイムアウトの1行、事故を大きくする素直なリトライと指数バックオフ+ジッター、ライブラリを使わず30行で書くサーキットブレーカ(閉・開・半開)、Redis が落ちても遅いDBから返す縮退、同時実行数を区切るバルクヘッドまでを順に入れます。最後に「1台のうちはタイムアウトだけで十分」という線も正直に引きます。 -
フロントエンド
node_modulesが重い理由 — pnpmとBunを測る
npm install が遅い・node_modules が重い、を感想で終わらせずに du と time で測る。npm・yarn・pnpm の違いはディスクの使い方にあること、pnpm のハードリンクとシンボリックリンクを ls と stat で実際に見ること、pnpm が厳しいのは意図的で、npm の平らな node_modules は「動いていたコードが自分の変更なしに壊れる」バグを生むこと。ロックファイル3種は互換性が無いこと。Bun の速さの実測と、まだ全部は動かないこと。そして Vite の裏で esbuild と Rollup が役割分担している理由と、それらが速い理由。結論は「今から始めるなら npm のままでいい」。 -
フロントエンド
JavaScriptを送らないサイト — AstroとSSG
記事を読むだけのページに、React は要るのか。ここまで作ってきたものは、押すところが1つも無い画面にも JavaScript を全部送っています。この回では Astro でブログを1本作り、出来上がった dist/ の中に script タグが1個も無いことを grep で数えて確かめます。そのあと React コンポーネントを1つだけ埋めて、そこだけに JS が載ることを見ます。Eleventy と VuePress の棲み分け、Markdown をどこに置くか、そして SSG が向かないものまで。最後に、このサイトが WordPress のままである理由を正直に書きます。 -
DevOps
そのイメージはVMの中にしかない — レジストリを立てる
CIでビルドしたイメージは、いまどこにあるのか。答えは「そのマシンの中だけ」で、それは他のどこでも動かせないという穴です。ソースではなくビルド結果=成果物の置き場という考え方を整理し、山場として自分のVMに Docker 公式の registry を立てて push / pull します。Nexus や Artifactory は重いので立てません。https でないと拒否される定番の詰まりを、なぜそうなっているのかから解きます。latest を本番で使わない理由、会社がなぜ社内レジストリを立てるのか、cosign と SBOM の名前、そして古いイメージが溜まる話まで。 -
アプリ
「動く」と「使える」の差は4つの状態 — Reactの画面
APIは前回で動いています。ここからは人が触るものを作るので、判断の基準が「正しいか」から「分かるか」に変わります。hitokoto の画面を3枚だけ作り、Vite の server.proxy で開発中のCORSを消し、そのうえで山場として「読み込み中 / 空っぽ / エラー / 正常」の4つの状態を全部書きます。一番忘れるのは空っぽです。初めて開いた人が最初に見る画面がそこだからです。フォームの二重送信を止め、失敗しても入力を消さず、デザイントークンとButtonを作り直さずに使い回します。最後は npm run build して nginx から dist/ を配り、/api をプロキシして「本番の形」で確認します。開発サーバーでしか動かない状態で終わりにしません。 -
アプリ
全部書いてから動かさない — 作品のAPIと認証
作品づくりの2本目。練習用の ~/server は開けず、新しく ~/hitokoto を作るところから始めます。テーブルより先にマイグレーションを書き、外部キーの ON DELETE を用途で選び分ける。URLの一覧を表で先に決めてから、まず POST /api/books と GET /api/books の2本「だけ」を通す。動いたら次を足す。登録画面は作らず管理者1人を seed で用意し、書き込みだけログインを要求する。入力の検証とエラーの形を1つに揃え、公開用のAPIを別の道に分けて、画面が無いまま curl で全部確かめ、systemd で常駐させるところまで。 -
OS
BIOSの画面出力が消える — 32bitモードとキーボード
前回の512バイトは16bitのリアルモードで動いていました。使えるメモリは1MB、保護は一切なし。GDTを作りA20を開いてcr0の1ビットを立てると32bitに移れますが、その瞬間BIOSの画面出力が使えなくなります。0xb8000に直接書いて文字を出し、ポート0x60からキーボードを読むところまでを、1行ずつ確かめます。 -
プログラム
索引が「速い」の正体 — データベースを自作する
MySQLに INSERT した瞬間、ディスクでは何が起きているのか。索引を張ると速くなるのはなぜか。答えを読むかわりに、Node.jsで30行の「追記するだけのデータベース」を書いて確かめます。書き込みは速いのに読み出しが全行走査で遅いところを20万件で実測し、メモリ上に「キー→ファイル内の位置」の索引を足して桁を変える。さらに書いた直後にプロセスを殺してデータを消し、fsync がなぜ要るのか、トランザクションログが何のためにあるのかを体で理解します。削除しても消えない追記ログ、墓標とコンパクション、B+木との違い、そして範囲検索ができないという限界まで。 -
アプリ
公開の前に、戻せることを確かめる — デプロイと運用の入口
hitokoto はまだ自分のVMの中でしか動いていない。「公開する」を「届く場所に置く・名前を付ける・暗号化する・落ちても戻せる」の4つに分解して、順に埋める。山場はバックアップと復元で、わざと消して戻せることを確かめてから外に出す。独自ドメインもVPSも無くても、VMの中で本番と同じ形を最後まで作れるようにした。 -
プログラム
gitは差分を保存していない — コミットを自作する
毎日打っている git commit が、ディスクの上で何を作っているのか。先に本物の .git の中を開いて、blob・tree・commit の3種類しか無いことを確かめます。そのうえで同じものを Node.js で114行書き、自作した mygit が作ったオブジェクトを本物の git cat-file と git log に読ませます。ブランチが41バイトのテキストであること、Gitが差分ではなく毎回まるごと保存していることまで、実物で確認します。