ミドルウェア

nginx、MySQL、Redis、Docker —— 名前はよく聞くけれど、何のためにあるのかが分からないまま入れがちなものを扱います。

書き方の方針

各記事で必ずこの3つを書きます。

  1. なぜ要るのか — これが無いと何が困るのか
  2. 入れ方 — コピペで再現できるコマンド
  3. 最小の動作確認 — 入れただけで満足しないための、動いたと確認できる一手

「インストール手順」だけの記事は、詰まったときに役に立たないので書きません。

ミドルウェアは、何と何の間にあるのか

OS の上、自分のアプリの下にいるもの——それがミドルウェアです。名前のとおり「中間」にいます。

  自分のアプリ        ← 作りたいもの
  ─────────────
  ミドルウェア        ← nginx / MySQL / Redis / Docker …
  ─────────────
  OS(Linux・Windows) ← ファイル・プロセス・ネットワーク
  ─────────────
  ハードウェア

どれも、頑張れば自分で書けます。 このサイトでは実際に、HTTPサーバーもデータベースもシェルも自作しています。書いてみると、こう分かります。

書けないから借りるのではなく、書くと本業が進まないから借りる。

そして、借りると仕事が減るのではなく、種類が変わります。 設定・起動の管理・監視・バックアップ・バージョン更新が新しく増えます。だから各記事には 「入れないほうがいい場面」 を必ず書いています。

6つの分類 — それぞれ何を肩代わりしているのか

分類肩代わりしていることこれが無いと困ること記事
Webサーバー受け取って、配る。暗号化と振り分けもここアプリを直接 80 番に晒すことになる。証明書も静的ファイルも自前になる3 本
キャッシュとキュー覚えておく。あとで実行する同じ計算を毎回やり直す。重い処理の間、利用者を待たせ続ける2 本
コンテナ動かす場所を、そのまま持ち運ぶ「自分の環境では動く」が消えない。手順書が唯一の再現手段になる4 本
Kubernetes複数台に配って、落ちたら戻す台数が増えた瞬間に、配置と復旧が全部手作業になる6 本
Windows Server社内の利用者・PC・権限を1か所で決める1台ずつユーザーを作ることになる。3人目で破綻する10 本
仮想化壊してよい機械を、何台でも用意する練習のたびに本番のPCを汚す。戻せない4 本

データベースは、この分類には置いていません。 ミドルウェアの代表格ですが、このサイトではロードマップ側(バックエンドの続き)とSQL の深掘りで扱っているためです。導入だけを切り出すより、アプリから繋いで使う流れの中で読んだほうが分かるという判断です。

いつ入れて、いつ入れないか

「有名だから入れる」をやめるための目安です。 どれも、記事の中で実際に測ったうえで書いています。

分類入れる合図まだ入れないでよい状態
Webサーバー複数のアプリを1つのドメインで出したい。HTTPS を付けたい手元のVMで自分だけが見ている
キャッシュ測って、同じ問い合わせが繰り返されていると分かったまだ遅くない。または、どこが遅いか測っていない
キュー1回の処理が数秒かかり、その間 API が返せない処理が一瞬で終わる。失敗しても手でやり直せる
コンテナ同じ環境を別の機械でも立てたい。依存が絡み始めた1台で、1つのアプリだけを動かしている
Kubernetes1台では成立しない(落ちたら困る・台数を変えたい)1台で足りている。Compose で困っていない
Windows Server利用者とPCが複数あり、権限を揃えたい個人の開発機だけ
仮想化最初に入れる。 このサイトの前提——

「まだ入れないでよい状態」に当てはまるなら、入れないのが正解です。 入れた瞬間から、それを動かし続ける仕事が始まります。

記録

Webサーバー

  1. nginxを入れたのに繋がらない — Webサーバーの導入
    apt install nginx は一瞬で終わる。問題はそのあと、ブラウザで開いても繋がらないこと。原因は3つに絞れる。VMの中にWebサーバーを立てて、ホストのブラウザから見るまでを、確認コマンド付きで。
  2. ポート番号を隠す — nginxのリバースプロキシ
    これまで :8000 を付けて開いていたが、世の中のサイトにポート番号は付いていない。前に立つnginxが受けて、後ろのアプリに渡しているから。1台で複数サイトを配る方法と、502の読み方。
  3. Webサーバーはnginxだけではない — ApacheとCaddy
    nginxを入れたが、なぜnginxなのかは説明していなかった。Apacheを別ポートで立てて.htaccessを動かし、Caddyで証明書が自動で取れるのを見る。動いているnginxを壊さずに比べて、最後に全部片づける…

キャッシュとキュー

  1. キャッシュは消すのが一番難しい — Redisの導入
    速くしたいから入れる、の前に必ず測る。20万件の集計を実際に遅くしてから Redis を入れ、TTL とキー設計を決め、「更新したのに古い値が返る」事故をわざと起こして直します。セッションを MySQL から Redis…
  2. 待たせるAPIをやめる — メッセージキューとRabbitMQ
    5秒かかる処理をリクエストの中でやると、利用者は5秒待たされます。まず本当に遅いAPIを作って測り、それを「受け取ったら即返す・処理は別プロセス」に組み替えます。RabbitMQ を Docker Compose で立て…

コンテナ

  1. コンテナは軽い仮想マシンではない — Dockerの導入
    「軽いVM」という説明は分かった気になれるが、間違い。カーネルを共有しているという1点を押さえると、起動が一瞬な理由も、消えると困る理由も繋がる。公式手順での導入と、最初に踏む落とし穴。
  2. Composeなら1コマンド — 複数コンテナをまとめる
    docker run のオプションを毎回打つのは続かない。しかもアプリはWebサーバー1つでは終わらず、データベースも要る。compose.yaml に書いて up 一発にする方法と、depends_on が待ってくれな…
  3. 1コマンドで環境が丸ごと立つ — Dockerの到達作品
    Docker をひととおり触ったあと、「じゃあ自分のアプリを立ててみて」と言われて手が止まりました。コンテナ1つは動かせても、アプリとデータベースを繋いで、データを残して、起動順まで面倒を見る——ここが別の山だからです。…
  4. Kubernetesは重すぎた — Swarmという選択肢
    kubeadm で3台クラスタを組み、ArgoCD まで入れたあとに、正直な問いを1つ置きます。もっと簡単な選択肢は無かったのか。答えは「ある。ただし引き換えがある」です。1台の Compose から、数台の Swarm…

Kubernetes

  1. Kubernetesは「状態を宣言する」 — minikube入門
    docker run は「こう動かせ」という命令、Kubernetes は「この状態であれ」という宣言。違いは、コンテナを手で消したときに分かる。Pod / Service / Deployment を Compose …
  2. 1台落としてもPodは移る — kubeadmで組む3台クラスタ
    minikube は1台なので、落ちたら全部落ちる。VMware でVMを3台(クローン2台)用意し、kubeadm でコントロールプレーン1台+ワーカー2台のクラスタを組む。クローンの machine-id 重複、CN…
  3. 壊れても直り、止めずに更新 — Kubernetesの到達作品
    Kubernetes コースをひととおり触ったあと、「じゃあ自分のアプリを乗せて公開して」と言われて手が止まりました。部品は分かっても、1つの動くサービスに束ねるのは別だからです。この記事は Kubernetes コース…
  4. Helmは結局YAMLを作るだけ — Kubernetesのパッケージ管理
    開発用と本番用でレプリカ数とイメージのタグだけ違うのに、マニフェストを丸ごとコピーしていませんか。Helm は「Kubernetes の apt」で、チャートという単位でアプリを配ります。使う側から入り、values.y…
  5. 手で直した設定は勝手に戻る — ArgoCDでGitOps
    前回までのデプロイは「押し込む」やり方でした。GitHub からVMには届かないので、セルフホストランナーで解きました。GitOps はまったく別の解き方で、クラスタ側から Git を見に行きます。ArgoCD を mi…
  6. サーキットブレーカを自分で書かない — サービスメッシュ
    前回、サーキットブレーカを自分のコードに30行で書きました。ではサービスが10個あったら10回書くのか、Goで書いた1個はどうするのか、という問いから始めます。サービスメッシュは「通信の面倒をアプリの外に出す」仕組みで、…

Windows Server

  1. Windows Server評価版の導入|180日の期限とslmgr /rearmでの延長
    Windows Server の評価版を VMware に入れて、名前・IP・タイムゾーン・RDP まで設定するところまで。180日で止まる仕組み、Desktop Experience と Server Core の選び…
  2. 役割と機能は違う — Windows Serverに何を入れるか
    役割(Role)と機能(Feature)を混同したまま調べると必ず迷子になります。AD DS から IIS、Hyper-V、WSUS まで主要な役割を表で網羅し、Get-WindowsFeature での一覧の出し方と、…
  3. Windows Updateが当たらないときの確認 — PowerShellでの適用と再起動運用
    Windows Updateを手で当て、当たらないときにイベントログ・サービス・キャッシュの順で切り分けます。勝手に再起動させない設定と、KBを指定して戻す方法、戻せない更新があることも扱います。
  4. Active Directoryの構築手順|DC昇格からクライアントのドメイン参加まで
    1台ずつユーザーを作る運用がなぜ破綻するのかから始めて、AD DSの役割追加、ドメインコントローラーへの昇格、クライアントの参加、OUとユーザー作成、グループポリシーの適用確認までを、用語を日常の言葉に言い換えながら通し…
  5. Windowsイベントログの見方|まず見る3つのログと絞り込み方
    時刻・ログ・レベル・IDの順に絞り込み、原因の1件に辿り着く手順です。再起動やサービス停止、ログオン失敗の調べ方と、Securityログが数日で消える理由も扱います。
  6. 共有とNTFSの権限の違い|厳しいほうが勝つ仕組みとGPOでの設定手順
    Active Directory を立てただけでは何も便利になっていません。ファイルサーバーの役割を追加して共有フォルダを1つ作り、共有のアクセス許可とNTFSのアクセス許可という2階建ての仕組みを、わざと食い違わせて確…
  7. Windows Serverで社内DNSを構築する手順|ゾーンの作成とnslookupでの確認
    IPは合っているのに名前でアクセスすると繋がらない、という症状の正体はほとんどDNSです。Windows Server にDNSの役割を追加して、正引きゾーンと逆引きゾーンを別々に作り、フォワーダで外部の名前解決を委ねる…
  8. 共有フォルダにアクセスできない原因の切り分け|SMB・名前解決・権限の順に確認する
    名前解決・到達・認証・共有の権限・NTFSの権限を上から順に潰します。同じエラーが出る2つの層の見分け方と、再起動で直る正体である資格情報の残骸まで扱います。
  9. DHCPサーバーの構築手順|ADでの承認(認可)とスコープの設定
    クライアントに勝手に 169.254 で始まる変なIPが付いて、誰とも通信できない。あれは「DHCPからIPを貰えなかった」というサインです。Windows Server に DHCP の役割を入れ、スコープを1つ作り、…
  10. Cドライブの空き容量を増やす|WinSxS・ログ・Windows.oldの扱い
    掃除の前に測ります。WinSxSの見た目のサイズが嘘である理由、実務で最も多い増え続けるログの見つけ方、消してはいけないもの、そして埋まる前に気づく仕組みまで。
  11. GPOが適用されない原因|リンク先・OU・適用順の仕組みとgpresultでの確認
    GPOを作って設定を入れたのに、クライアントに何も反映されない。この記事は、その「効かない」を機械で切り分けます。効かない理由の9割は適用先(リンク)で、残りは適用順(LSDOU)と反映タイミングです。OU設計・作成とリ…
  12. ブルースクリーンの原因の調べ方|メモリダンプの設定とWinDbgでの解析
    青い画面の停止コードとメモリダンプから犯人を特定します。まずダンプが取れる設定か確かめ、わざと落として、イベント1001から読み解くところまでやります。
  13. sysprepで一般化する手順|クローンのSID重複を防ぎunattend.xmlで無人化
    検証用のサーバーを1台ずつ手で作っていたら日が暮れました。じゃあクローンすればいい、と単純コピーしたら、ドメイン参加やライセンスがおかしくなります。原因は、Windowsが1台ごとに持っているSIDが重複するからです。複…
  14. インストール失敗とサービスが起動しない原因|msiexecのログとイベントID 7000
    インストーラに詳細ログを出させ、Return value 3 から原因を特定します。サービスが開始してすぐ止まる症状をわざと作り、イベントIDで見る場所を分けます。
  15. 検証ラボをVMで複数台にする手順|1台では気づけない不具合を一斉に確かめる
    これまでの Windows Server の回(導入・役割・AD・ファイル共有)を、1つの閉じた検証ラボにまとめて一斉に動かします。DC・メンバーサーバー・クライアント数台を1枚のネットワークに並べ、ドメイン参加・DHC…
  16. PowerShellリモート処理の設定|Enter-PSSessionとInvoke-Commandの使い分け
    サーバーが増えると1台ずつの作業は破綻します。WinRMを有効にして複数台へ同時にコマンドを送り、結果を1つの表にまとめるところまでを実際にやります。
  17. ドメインの時刻同期 — 5分ずれるとログインできなくなる仕組みとw32tm
    時計が5分ずれるとドメインの認証が通らなくなります。時刻がどの階層で配られているかを辿り、わざとずらしてログインを失敗させ、直すところまでをやります。
  18. ドメインコントローラーを2台にする手順|冗長構成とrepadminでの確認
    DCが1台だと再起動1回で全員が止まります。2台目を昇格し、変更が伝わることを確かめ、1台目を止めてもログインできるところまでを実際にやります。
  19. Windows Serverのバックアップと復元|wbadminのシステム状態と戻せることの確かめ方
    ADや役割の設定はファイルのコピーでは戻りません。システム状態を取り、わざとユーザーを消して、ごみ箱と復元モードの2通りで戻すところまでをやります。
  20. 共有フォルダの監査ログの設定|誰が削除したかをイベントID 4663で追う
    消えたファイルの犯人は、設定していなければ分かりません。削除だけを記録する監査を入れ、実際に消してイベント4663から取り出すところまでをやります。
  21. Windows Serverの制作演習 — AD・GPO・共有で新しい利用者を迎える
    新しい社員を1人受け入れる作業を、ドメインコントローラーで1回スクリプトを流すだけで終わらせます。AGDLPでのグループ設計、共有とNTFSの権限、GPOの当て方を、証拠を5つ出して確かめます。

仮想化

  1. Windowsの仮想化はどれを選ぶか — Hyper-V・VMware・WSL2
    Hyper-V、VMware Workstation、WSL2、VirtualBox。名前は聞くが違いが分からない4つを整理して、自分のPCが対応しているかを実際に確認した。先に知らないと詰む「共存問題」つき。
  2. VMware Workstation導入 — 無料化後の初期設定
    VMware Workstation Pro は2024年11月から個人利用も無料になった。ただし入手先はBroadcomへ移り、アカウント登録が要る。入れる前の仮想化確認から、保存先・仮想ネットワーク・メモリ上限の初期…
  3. Ubuntu ServerのVMを立てる — VMware Workstation
    練習用の Ubuntu Server を VMware Workstation で1台立てる手順。割り当ての決め方、インストールの分かれ道、スナップショット、ホストからのSSH接続まで。忘れたり詰まったら、ここに戻れば直…
  4. Ubuntu Server初期設定の要点8つ — VM学習用
    VMwareにUbuntu Serverを入れた直後の素の状態は、時刻もIPも更新設定も未調整のまま。更新・open-vm-tools・タイムゾーン・ホスト名・IP固定・SSH鍵認証・ufw・自動更新の8つを、なぜやるの…