ロードマップ挑戦– category –
roadmap.sh のロードマップを、読むだけで終わらせず実際に構築して検証する記録。
-
Linux
サーバーの中身はテキスト — grep・sed・awkとvim
設定もログも全部ただのテキストファイル。GUIが無いサーバーでは「探す・切り出す・置き換える」が仕事になる。grep・sed・awkを最低限だけ覚えて、ログから一番多いIPを出すところまでやる。vimから出られない問題も先に片付ける。 -
DevOps
「遅い」の次は「どこが」 — 分散トレーシング入門
メトリクスで「遅い」に気づき、ログで「何が起きたか」を読み、それでも「どこで時間を使ったか」だけが分かりませんでした。パフォーマンスの回で手で仕込んだ console.time を、全部の処理に自動で入れるのが分散トレーシングです。OpenTelemetry が「規格」であって道具ではないという整理から始めて、Node.js に自動計装を入れ、Jaeger を立てて、実際に遅いリクエストを1本開いて内訳を見ます。サンプリングと、1台なら要らないという線も書きます。 -
システム設計
キャッシュは4箇所にある — Cache-ControlとCDN
Redisで作ったキャッシュは、実は4箇所あるうちの一番奥だけでした。ブラウザ・CDN・リバースプロキシ・アプリを地図にして整理し、nginx で Cache-Control を自分で付けて、開発者ツールで from disk cache と 304 が出るところまで見ます。ハッシュ付きファイルは1年・HTMLはキャッシュしない、という定石の理由も回収します。proxy_cache でアプリにリクエストが届かなくなるのを確かめ、最後にわざと事故を起こします。CDNは仕組みの説明だけで、契約はしません。 -
システム設計
自分のページをCSPで壊す — Webの防御ヘッダ
入力を検証しても、書き忘れる日が来ます。この回はその2枚目としてブラウザ側に守らせます。nginx で Content-Security-Policy を付けて、自分のページのインラインスクリプトが本当に止まるところまでやります。Report-Only で先に試す手順、付けるべきヘッダ3つ、そして OWASP Top 10 を「自分のアプリの点検表」に翻訳するところまで。 -
バックエンド
実行ファイル1つで動く — Goで同じAPIを書く
言語を1つしか知らないと、「その言語の性質」と「プログラミング一般」の区別が付かなくなる。だから2つ目を触る。ただしGoの入門はしない。第5段階の最初に書いた15行のNode.jsサーバーと、同じ/api/tasksを返すGoを、行ごとに並べて比べるだけ。コンパイルすると実行ファイルが1つできて、Node.jsもGoも入っていない環境でそのまま動く。ldd と ls -lh で確かめて、Dockerイメージが小さくなる理由まで繋げます。このサイトは引き続き Node.js で進めます。 -
バックエンド
1画面のために3回叩く — GraphQLとRESTの違い
一覧画面を1つ作るのに、いまのREST APIは何回叩くことになるのか。実際に数えて、過剰取得と不足取得を目で見るところから始めます。GraphQLは「1つのURLにPOSTするだけ」でRESTと同じHTTPの上に乗っていること、スキーマが契約になること、既存のRESTを消さずに /graphql を足す実装、そしてGraphQLが極端にN+1を起こしやすいことを101本のSQLログで確かめます。最後に、失われるもの(HTTPキャッシュ・エラーが200で返る・認可が複雑になる)を正直に並べて、個人のサービスならRESTで十分だという結論まで書きます。 -
システム設計
まだマイクロサービスにしない — モノリスと12 Factor
「そろそろマイクロサービスにすべきか」に答えを出します。結論は「しない」です。いま動いている ~/server がモノリスであることを確認し、分けた瞬間に増える仕事(ネットワーク越しになる・トランザクションが効かない・ログが分断される・デプロイが増える)を、関数呼び出しとHTTPの往復時間を実際に測って確かめます。そのうえで 12 Factor App を暗記する対象ではなく自分のアプリの点検表として使い、12項目を「できている / 怪しい / まだ関係ない」に仕分けます。唯一できていなかった停止時の後始末だけを直し、最後にモジュラーモノリスという中間の選択肢を置きます。 -
データベース
部分一致は索引が効かない — 全文検索とMeilisearch
検索窓を付けた瞬間に書く LIKE '%文字%' が、なぜ20万件で止まるのか。EXPLAIN で「索引が1つも使われていない」ところを実際に見せます。日本語には単語の区切りが無いという本質的な難しさを踏まえ、まず MySQL の FULLTEXT + ngram でどこまで戦えるかを試し、足りないところから Meilisearch を Docker Compose で立てます。タイプミスに強い検索を実演し、最後に「検索用のデータはコピーである」という一番大事な話と、Elasticsearch との使い分け、そして入れないほうがいい場面まで。 -
DevOps
.envは暗号化してGitに置ける — SOPSとage
GitOpsの回で「秘密情報はGitに置けない」と名前だけ挙げて先送りにしました。その回収です。まずコマンドで自分のVMを棚卸しして、.envが何枚あるか・履歴に入っていないかを確かめます。そのうえで置き場所には段階があること(.env → 環境変数 → SOPSで暗号化してGit → Vault)を整理し、山場としてSOPSとageで.envを暗号化します。キーは読めて値だけ暗号化されるので、Gitの差分がそのまま読めます。最後に残る「鍵をどこに置くのか」という問題も、ごまかさずに書きます。 -
データベース
MySQLとPostgreSQLの違いは1割 — 移して確かめる
2つ目のデータベースを触ります。目的は「どちらが優れているか」を決めることではありません。1つしか知らないと、それがSQLの仕様なのかMySQLの仕様なのかが区別できないからです。PostgreSQLを入れて(最初の関門は認証です)、同じテーブルに同じSQLを打って9割同じことを確かめ、残り1割を1つずつ手で潰します。最後にKnexの接続先を差し替えて、マイグレーションがどこで落ちるかを見ます。