記事一覧

開いたファイルが3000行、目当ての関数だけで800行。スクロールしているうちに、さっき読んだ分岐を忘れてしまう。長いコードが読めないのは、あなたの読解力の問題ではありません。上から順に全部を読もうとすると、誰でも迷子になります。目的を1行で決め、地図を描き、値を1つだけ追う。一人保守の現場で続けられる「長い関数・巨大ファイルの読み方」を、手順とチェックリストにまとめました。

「CSSを直したのに、利用者の画面だけ崩れたまま」。そのたびに「スーパーリロードしてください」とお願いしていませんか。反映されないのは作業ミスではなく、ブラウザがちゃんと覚えているからです。ファイル名やURLを変えて新しい版を読ませる「キャッシュバスティング」を、HTMLとJS・CSSでキャッシュの持たせ方を分けるところから、一人運用の手順に落として整理しました。

「tmp_」「_old」「bk20xx」——名前からして怪しいのに、消していいのか分からないテーブルやカラム、ありますよね。DBの統計・コードの横断検索・人への確認の3つで使用実態を確かめ、名前を変えて待つ→退避して消す、と段階を踏むやり方を、MySQL/PostgreSQLの確認SQLつきで整理しました。

「CPU 40%です」と言われて、それが高いのか普通なのか答えに詰まったことはありませんか。障害に早く気づけるかどうかは、監視ツールの数より「ふだんの値」を知っているかで変わります。平日昼・夜間・月末で平常値の幅をつかむ手順を、sar とアクセスログのコマンド例、1枚の平常値メモつきで整理しました。

「直ったはずなのに、ときどき前の画面が出る」。その原因が、2台あるサーバーの片方だけに反映し忘れていたことだった経験はありませんか。漏れるのは注意が足りないからではなく、手順が「1台ぶん」で書かれているからです。対象サーバーの洗い出し、同じ手順を全台に回すやり方、1台ずつ直接たたいて確かめる方法を、そのまま使えるコマンド例つきで整理しました。

「たまに注文が消える」と言われてログを開いたら、手がかりが1行もない。ログが足りないのは、あなたの手落ちではなく、書いた時点では誰も困っていなかったからです。改修のついでに、あとから原因を追えるログを仕込む場所・書く中身・書かないものを、そのまま使える書き方の例つきで整理しました。

障害がやっと落ち着いて報告書を開いたら、「何時に何をしたんだっけ」と手が止まる。夢中で対応していたら、覚えていないのは当たり前です。対応しながら片手間で続けられる時系列メモの取り方を、そのまま使えるテンプレートと、ターミナルの記録を残すコマンド付きで整理しました。

「問い合わせ先のメールアドレスを変えてほしい」。1行で済むはずの依頼なのに、検索したら同じアドレスがあちこちに埋まっていた——レガシー保守ではよくある場面です。ハードコードされた値を見つけて一覧にし、行き先を仕分けて、振る舞いを変えずに少しずつ外へ出す手順を、そのまま使える検索コマンドとチェックリスト付きで整理しました。

昨日まで普通だったのに、今日から急にサイトが重い。DBが怪しいと思っても、どこから見ればいいのか迷いますよね。いま走っているクエリの見方、記録から犯人を探す設定、止めていい処理の見分け方までを、一人で対応する前提で順番に整理しました。

サーバーを移して、あとはDNSを向け替えるだけ。作業自体は1行なのに、押す直前で手が止まりますよね。反映も切り戻しも自分の手を離れるからです。TTLをいつ短くするか、切り替え当日に何を見るか、戻すときに本当に効く備えは何かを、一人運用の段取りとして順番に整理しました。

設定ファイルの変更は「1行だけ」のことが多いのに、コード改修より緊張しますよね。守る網がないまま、いきなりサーバー全体に効いてしまうからです。退避・差分・構文チェック・反映・確認の5つを、順番どおりに小さく通す手順を整理しました。

二要素認証は「入れたほうがいい」と分かっていても、自分が入れなくなったら誰も助けてくれない一人運用だと、手が止まりますよね。締め出されないためのリカバリ設計を先に決めてから入れる順番を、cronやAPIが止まる落とし穴も含めて一緒に整理します。

セキュリティヘッダは「入れたほうがいい」と分かっていても、どれから入れるとどこが壊れるのかが読めなくて手が止まりますよね。副作用の小さい順に3つだけ入れる手順と、入れる前後の確認方法を一緒に整理します。

サイトの改ざんは、見た目が変わらないまま起きることがほとんどです。だから「毎日見ているから大丈夫」では気づけません。外から・中から・記録から、の3つの入口で気づく仕組みを、一人運用でも続けられる小ささから整理しました。

メールを送る機能に手を入れるリリースは、他の改修より少しだけ緊張しますよね。押した瞬間に外へ出ていって、取り消せないからです。誤送信を「気をつける」で守らずに済むよう、止める・試す・開けるの3段で通す手順を整理しました。

「この画面、たぶんもう誰も使っていない」——そう思いながら消せずに残っている機能、ありますよね。判断材料がないまま消すのは怖いものです。使用実態の確かめ方から、いきなり削除せずに段階を踏んで止める順番まで、一人運用の現場目線で整理しました。

「たまに落ちるけど、見に行くと直っている」——この断続的な障害（フラッピング）がいちばん追いにくいですよね。見に行った時点で証拠が消えているからです。落ちた瞬間を捕まえるより先にやることを、記録の集め方から仕掛けの入れ方まで、一人運用の現場目線で整理しました。

「集計が1日ズレている」「深夜に登録した分だけ前日に入る」——数字が合わないのに、コードのどこも間違って見えない。日付とタイムゾーンのバグは、そういう顔をして現れます。ズレの正体を確かめる順番を、一人運用でも今日から追える形に整理しました。

「アップロードが失敗する」を直すために、あの日 777 にしたところ。そのままになっていても、責められることではありません。パーミッションの数字の読み方から、誰で動いているかの確かめ方、戻せる形で直す順番までを、一人運用でも今日できる形に整理しました。

作業のときに置いたバックアップや調査用のファイル、そのままになっていないでしょうか。責める話ではなく、忙しい現場では誰にでも起きることです。公開ディレクトリに何が置きっぱなしになっているかを洗い出し、外から見えていないかを確かめる手順を、一人運用でも今日できる形に整理しました。