-
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の接続先を差し替えて、マイグレーションがどこで落ちるかを見ます。 -
バックエンド
OAuthはログインの仕組みではない — 認可とOIDC
「GitHubでログイン」を自分のExpressに付ける。ただしOAuthは認可の仕組みで、ログインに使うための拡張がOpenID Connect。認可コードフローを画面遷移の順に分解し、stateの検証、NATの内側のVMでコールバックをどう受けるか、既存のusersテーブルとどう繋ぐかまで。 -
データベース
スキーマは消えずにアプリへ移る — NoSQLとMongoDB
「NoSQL」は1つのソフトの名前ではなく、少なくとも4種類の別物の総称です。すでに使っている Redis もその1つ。Compose で MongoDB を立て、同じタスク一覧をドキュメントとして入れ直し、SQLとの対応を1行ずつ突き合わせます。そのうえで「スキーマがないから楽」が誤解である理由、結合が多いデータに向かない理由、トランザクションが標準では使えない理由まで。最後は「迷ったらリレーショナル」の根拠を書きます。 -
フロントエンド
E2Eはsleepで待たない — Playwrightで1本目
テストの回で「E2Eは最後に、数本だけ」と先送りした約束を回収する。画面の無いUbuntu Serverでブラウザが動くのかという最初の関門から、npm init playwright@latest、フロントとAPIを両方立ててログイン・追加・一覧まで通す1本目まで。山場は待ち方で、sleepで待った瞬間にテストは遅くなり、しかも壊れる。Playwrightの自動待機が何を待ってくれて何を待ってくれないのかを分けて、落ちたときに見るもの(トレース・スクリーンショット・動画)を、GUIの無いVMからどう開くかまで。最後は「E2Eを増やすと開発が止まる」話。 -
DevOps
同じ設定を3台に手でやらない — Ansible入門
クラスタの回でVMを3台作り、同じ下ごしらえを3回やりました。4台目でまた同じことをするのか、という話です。Ansibleは「サーバーがどうあるべきか」をYAMLに書き、SSHで入って合わせに行く道具です。Terraformが「作る」ならAnsibleは「設定する」。シェルスクリプトと何が違うのか(べき等)を実例で潰したうえで、インベントリを書き、pingを通し、初期設定の回でやったタイムゾーン・パッケージ導入・ufwをプレイブックで再現します。--checkを先に打ち、2回目にchanged=0が出るところまで見ます。 -
バックエンド
サーバーから勝手には送れない — WebSocketとSSE
HTTPは「聞かれたら答える」しかできない。だから最初は2秒ごとに聞き直すことになり、無駄なリクエストがログに積み上がるのを実際に見ます。そこからロングポーリング・SSE・WebSocketへ順に進み、向き不向きを表にします。実装は ws パッケージ。nginx を前に立てたまま繋ぐと必ず失敗する Upgrade の話と、プロセスを2つにした瞬間に更新が半分の人にしか届かなくなる事故を、わざと起こして Redis の publish/subscribe で直すところまで。 -
フロントエンド
型は実行時には消える — TypeScriptを後から入れる
このサイトでこれまでに踏んだ事故は、ほとんどが「型があれば書いている最中に分かったもの」だった。無いプロパティを取ると undefined が返るだけ、URLから来た id は文字列、await を忘れた data.items も undefined。そこから TypeScript を導入する。ただし TypeScript は別の言語ではなく、JavaScript に型注釈を足しただけで、tsc がやるのはその注釈を消すことだけ。だから実行時には1ミリも守ってくれない。APIから来たJSONに型を書いても、中身は保証されない。既存の react-demo に、全部を一度に変えずに1ファイルずつ .tsx にしていき、Vite が型検査をしないこと、any を使うと全部が無意味になること、そして型を書きすぎないことまで。 -
データベース
全部やるか、1つもやらないか — トランザクションとACID
MySQLの回で「名前だけ覚えておいてください」と先送りにした宿題を回収します。送金の途中でわざとプロセスを落として3000円を消し、START TRANSACTION で消えないようにする。そのあとターミナルを2つ開いて、在庫1個の商品を2人に買わせてしまう事故を実際に起こし、SELECT ... FOR UPDATE で直します。デッドロックも自分の手で起こして、再試行するところまで。 -
DevOps
手で作ったものは再現できない — Terraform入門
前回のEC2は、画面をクリックして立てました。同じものをもう一度作れず、何を作ったかも思い出せません。Terraformは「あるべき状態」をファイルに書きます。マイグレーションやGitOpsと同じ発想です。Ubuntuに入れて、EC2を1台とセキュリティグループを作り、planを読み、最後に必ずdestroyします。tfstateを消すと管理できなくなること、Gitに入れてはいけない理由も書きます。