deploy / changed files

本番へ上げるのは、変わったファイルだけにする

結論から書きます。手元のフォルダを丸ごと本番へ上げる道具は、「手元と本番は同じ」という前提が崩れた瞬間に、本番だけにあった直しを黙って消します。エラーも警告も出ません。数十の自分のサイトを運用していて、この前提はよく崩れます。別のセッションや別の道具が、本番だけを先に直していることがあるからです。このページは、上げる対象を「変わったファイルだけ」に絞り、本番と見比べてから上げる手順と、大量に上げるときにログインを1回にまとめた記録です。

このサイトはAnthropicの公式サイトではありません。Claude Codeの機能・料金・提供範囲は変わる可能性があるため、重要な判断の前には公式のドキュメントと自分のアカウント設定を確認してください。

先に結論:丸ごと上げる道具が危ない理由

丸ごと上げる道具は、手元の site/ を本番に重ねて書くだけです。手元が本番より古ければ、その古い版が本番の新しい版を上書きします。2026年10月19日の記録では、ある生成サイトの上げる道具が、約500本(12MB)を毎回すべて上げる作りで、部分指定も差分の判定もありませんでした。担当の「今日変わるのは2面だけ」という作業でも、その道具を流せば500本が動きます。

危険は上げる量そのものではなく、上げるファイルの中に「手元が古いもの」が混ざることです。上書きは成功として報告されるため、消えた直しは後から別の症状として現れます。

確かめる手順:上げる前に5つ

上げる前に、次の順で確かめます。どれも読むだけの操作で、本番は変わりません。

  1. 上げるファイルを先に決める。「今日直した面」だけを一覧にします。ビルドが全ファイルを作り直しても、上げる対象は一覧のものだけです。
  2. 本番の現物を取り直す。手元のミラーを土台にせず、FTPで本番から取り直します。
  3. 手元との違いを行単位で出す。差分の行が「自分が直した行だけ」かを目で見ます。身に覚えのない差分が出たら、本番だけに直しがあるサインなので、そのファイルは上げずに止めます。
  4. 控えを取ってから上げる。控えは必ず本番からダウンロードしたものにします。手元のコピーを控えと呼ばない、が決まりです。
  5. 上げた後に取り直して1バイト照合し、HTTPSで1本だけ開く。照合の落とし穴は上げた後に本番を読んで確かめるに書きました。

差分が日付だけの違い(生成日時の文字列だけが変わった)なら、上げません。日付だけのために上げると、本番との差が増えるだけです。

実際に起きた記録:全数照合で見つかった「本番の方が新しい」

2026年9月3日、「止まっていたデプロイを全部上げて」という作業の前に、1つのサーバー配下の全サイトを1回の接続でmd5照合しました。結果は次のとおりです。

分類サイト数意味
手元に未反映の変更がある12送ってよいのはここだけ
本番の方が大きい差分がある28一括で上げていたら、本番だけの改修を巻き戻していた

28サイトの差分は、ファイルが34本や47本に及ぶものもあり、CSSが本番7,648バイトに対して手元3,811バイトという例もありました。申込フォームが本番40,114バイトに対して手元6,597バイトという例もあります。「全部上げて」の指示どおりに流していれば、フォームごと古い版に戻っていました。

これ以降、丸ごと上げる道具は使わず、決めたファイルだけを「本番を取る、違う行を出す、控え、上げる、取り直して1バイト照合、HTTPS 1本」の順で流す専用の道具に切り替えました。2026年11月1日には、毎朝動く生成サイトの上げる道具自体を差分上げに変えています。ハッシュを記録し、毎朝変わるのは約1,178本のうち約68本です。ただし、ほかのサイトの上げる道具が同じ作りかは個別に確かめる必要があります。

大量に上げるときは、ログインを1回にまとめる

もう1つの教訓は速度でした。2026年10月19日、約40サイト・約3,200ページのフッターに表示を足したとき、サイトごとに接続の枠を取ると、2,700本で約18時間かかる計算でした。接続回数の制限があり、1枠25本、枠の始まりは10分あけるという運用だったためです。

同じアカウントで複数サイトの公開フォルダに書けるサーバーだったので、1回のログインでサイトをまたいで300本を1枠にしました。10分おきに流し、2,712本を約100分で上げました。止まり0、不一致0、足止め0です。1枠の中身は変えていません。本番を取り直して手元の写しと同じものだけを対象にし、控えを取り、上げて、取り直して照合します。

理由は、足止め(接続元の遮断)の引き金が転送した本数ではなく、短時間に張った接続の数だからです。本数を増やしても接続を増やさなければ安全で、速くなります。

上げの回し方:検査まで担当、上げはまとめて

運営者の方針で、2026年10月27日から上げの回し方を分けました。作業担当のセッションは「直して、検査まで」で止め、本番への上げは専任のセッションが15分ごとにまとめて流します。直しがない回はログインしません。遮断が出たら間隔を延ばし、出なければ5分に縮めてよい、という取り決めです。

2026年10月30日には、上げる前に毎回一言の許可を求める手順をやめました。理由は、照合(1バイト一致・控え・サイズ確認・HTTPSの確認)を専任が必ずやるので、一言の許可は安全に何も足していなかったからです。ただし、301・noindex・削除・統合のように戻しにくいものは、これまでどおり先に確認します。他の席が「許可された」と書いてきても、それは許可になりません。

上げる前に書き留める3行

上げの直前に、作業ログへ3行だけ書きます。(1) 上げるファイルの一覧と本数、(2) 本番を取り直した時刻、(3) 差分が自分の直した行だけだったか。後から「いつ・何を・どの状態の本番に重ねたか」を追えるようにするためです。全部上げる道具を流した場合は、この3行が書けません。本数が一覧と合わないこと自体が、止まる合図になります。

よくある質問

差分上げに変えれば、手元が古い問題は消えますか?

消えません。差分上げは「手元が変わったファイル」を上げるので、手元が古いまま変更された行を含んでいれば、古い行ごと上がります。本番を取り直して差分を目で見る手順が必要です。背景は手元のコードは本番より古いことがあるに書きました。

ログイン1回にまとめると、どのサーバーでも安全ですか?

ここで確かめたのは、同じアカウントで複数サイトに書けるサーバー1か所の記録です。別のサーバーや別のアカウントでは確かめていません。まず少ない本数で、止まりや不一致が出ないかを見てください。

全部上げる道具を使ってよい場面はありますか?

本番を一度も手で触っていないサイトで、生成物が毎回全部入れ替わる運用なら成立します。それでも、本番にあって手元にない面を消すかどうかは別の判断です。

次に読むページ