公開の前に、戻せることを確かめる — デプロイと運用の入口

デプロイと運用の入口。公開サーバーとバックアップの箱、復元の矢印と確認チェック。

※本記事はアフィリエイト広告(PR)を含みます。

roadmap.sh のどこをやっているか

作品づくり。公開と運用は roadmap.sh の項目ではなく、道具の組み合わせ方の話。

前回: 「動く」と「使える」の差は4つの状態 — Reactの画面

はじめに のカリキュラムでは 第9段階「作品を1つ完成させる」 にあたります。

作業場所はVMの中(Ubuntu Server)です

~/hitokoto にサーバー側と画面側が揃っていて、nginx が dist/ を配り /api を後ろに渡している、 という状態から始めます。Windows の PowerShell で打つところは、その都度「Windows で」と書きます。

独自ドメインもVPSも、持っていなくて構いません

この記事は VMの中だけで最後まで手を動かせるように書いてあります。 外に出す手順(VPSを借りる・ドメインを買う)は選択肢として書きますが、必須にはしません。 お金を1円も使わずに、この回でやることは全部できます。

金額は書きません

VPSもドメインも、値段は提供元と時期で変わります。 この記事で「月◯円」と書いても、 あなたが見るころには違う数字になっています。必ず提供元の公式な料金ページを、自分の目で見てください。

hitokoto は動いています。

本を登録して、そこから引いた一文を残して、ログインして、自分の分だけが見える。ブラウザで http://192.168.226.50/ を開けば、ちゃんと画面が出ます。

そして、それだけです。

このURLを誰かに送っても、その人には何も表示されません。 192.168.226.50 は、あなたのWindowsとVMの間にしか存在しない住所だからです。作ったものは、世界のどこからも届かない場所にあります。

ここで、たいていの人が「公開する」という1つの作業を想像します。ボタンがあって、押すと出る、というような。

そんなボタンはありません。 「公開する」は、少なくとも4つの別々の仕事の集まりです。

分解すると具体的には無いとどうなるか
① 届く場所に置くインターネットから見えるサーバーに、アプリを動かす自分しか見られない
② 名前を付けるドメインを取り、DNSでその住所を指すIPアドレスを口頭で伝える羽目になる
③ 暗号化するhttps にするログインのパスワードが平文で流れる
④ 落ちても戻せるようにするバックアップ・復元・再起動・気づく仕組みある日データごと消える

そして、この4つには順番があります。 ①から順ではありません。

④を先にやります。

理由は単純で、①②③は失敗しても誰も困りませんが、④の失敗はデータが消えるからです。まだ誰も使っていない今なら、消しても平気です。誰かが使い始めてからでは、練習できません。

この回は、出す前の点検 → 戻せることの確認 → 置き場所 → 名前とhttps → デプロイの自動化 → 気づく仕組み、の順で進みます。

対象レベル: 中級 / 区分: 必修(第9段階「作品を1つ完成させる」の一部)

目次

この記事でわかること

  • 「公開する」は1つの作業ではなく、4つの別の仕事だということ。ボタン1つで終わる話ではない
  • バックアップは「取った時点」では存在しないこと。戻せて初めて存在する
  • 開発の設定のまま外に出すと、いくつかが黙って壊れること(secure なクッキーは nginx 越しだと発行されない、など)
  • Vite の VITE_ で始まる環境変数は、dist/ の中に文字列として焼き込まれること。秘密を置く場所ではない
  • 落ちたことに気づく仕組みは、Restart= と cron と curl で最低限は足りること。Kubernetes もCDNも、いまは要らない

この記事でやること

  1. 出す前のチェックリストを、コマンドで機械的に確認する(秘密がGitに入っていないか、デバッグ表示、エラーの中身)
  2. mysqldump でバックアップを取り、わざとデータベースを消して、戻す
  3. 本番用の設定を、開発用と分ける(NODE_ENV・.env・セッションのクッキー)
  4. デプロイを1コマンドのスクリプトにする(手順書をやめる)
  5. 落ちたことに気づく仕組みを、最低限だけ入れる

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
デプロイ書いたコードを、実際に動く場所へ運んで反映させること。「保存」ではなく「運んで動かすところまで」
VPSVirtual Private Server。インターネットから届く場所にある、自分専用の仮想サーバー。やることは今までのVMとほぼ同じ
mysqldumpMySQLの中身をテキストのSQL文に書き出すコマンド。書き出したファイルを流し込めば元に戻る
リストア(復元)書き出したバックアップを、実際にデータベースへ戻すこと。バックアップとは別の作業
certbotLet’s Encrypt から無料のSSL証明書を自動で取ってくる道具。更新も自動でやる
自己署名証明書自分で自分に発行した証明書。暗号化はできるが「本物である証明」はできないので、ブラウザは警告を出す
ヘルスチェック「生きてますか」を確かめるための、返事をするだけの小さなURL。ここでは /api/health
ロールバックデプロイして壊れたときに、前の動いていた状態へ戻すこと

何よりも先に、スナップショットを取る

この回ではデータベースをわざと消します。 障害対応の回と同じで、先に逃げ道を作ってから壊します。

VMware Workstation のメニューから [仮想マシン]→[スナップショット]→[スナップショットの取得]。名前は 公開前 としておきます。

[スクリーンショット: 01_スナップショット取得.png] VMware でスナップショットに 公開前 と名前を付けている画面を撮ってください。

取ってから先に進んでください。 この記事のどこで失敗しても、ここに戻れば無かったことにできます。

出す前のチェックリストを、目でなく機械で確認する

まず点検からです。そして、目で見て確認するのはやめます。

理由は、目で見る点検は、疲れているときに必ず飛ばされるからです。「たぶん大丈夫」で出したものが事故になります。コマンドにしておけば、疲れていても同じ結果が出ます。

確認するのは5つです。

#確かめること事故ったときに何が起きるか
1秘密情報がGitに入っていないかパスワードとセッションの鍵が、世界中から読める
2初期パスワードのまま出していないか総当たりで入られる
3デバッグ用の表示が残っていないか内部の値がブラウザの画面や通信に出る
4エラーの中身を外に返していないかファイルの置き場所やSQLの中身が攻撃者に渡る
5バックアップがあるか消えたら終わり

1. 秘密情報がGitに入っていないか

.gitignore に書いてあるかどうかは、確認になりません。 「あとから .gitignore に足した」場合、ファイルはすでに履歴の中に入ったままだからです。

見るのは「いま追跡されているか」と「過去に一度でも入ったか」の2つです。

bash
$ cd ~/hitokoto
$ git ls-files | grep -E '(^|/)\.env'

何も出ないのが正解です。 出たら、いま追跡されています。

過去も見ます。

bash
$ git log --all --name-only --pretty=format: | sort -u | grep -E '(^|/)\.env'

こちらも何も出ないのが正解です。1行でも出たら、そのファイルは履歴に残っています。 削除してコミットしても消えません。GitHub に上げてしまっているなら、まず中の値を全部作り直してください(パスワードもセッションの鍵も)。履歴から消す作業より、値を変えるほうが先で、確実です。

中身のほうも見ます。「.env に入れたつもりが、コードに直接書いてあった」が一番多い事故です。

bash
$ git grep -nE "(password|passwd|secret|api[_-]?key|token)\s*[:=]\s*['\"][^'\"]{6,}" -- ':!*.md'

出てきた行を1つずつ見ます。サンプル値やコメントなら問題ありません。 本物が混ざっていないかだけを見ます。

そしてもう1つ、画面側は特に危険です。

bash
$ grep -rn "VITE_" ~/hitokoto/client/src | head -20

VITE_ で始まる環境変数は、ビルドのときに dist/ の中へ文字列として埋め込まれます。

つまり、ブラウザで「ソースを表示」すれば誰でも読めます。 ここに APIキーやパスワードを入れると、公開した瞬間に公開されます。 実際に埋め込まれているかは、ビルド済みのファイルを検索すれば分かります。

bash
$ cd ~/hitokoto/client
$ npm run build
$ grep -ro "VITE_[A-Z_]*" dist/ | sort -u

VITE_API_BASE のような隠す必要のないものだけが出るなら問題ありません。画面側に置いていいのは「隠さなくていい設定」だけです。

2. 初期パスワードのまま出していないか

見るのは2種類です。データベースの接続用と、アプリのログイン用。

bash
$ grep -n "DB_PASSWORD\|SESSION_SECRET" ~/hitokoto/server/.env

password pass1234 hitokoto のような推測できる文字列なら、いま変えます。セッションの鍵は、自分で考えずに作らせます。

bash
$ openssl rand -base64 32

出てきた文字列をそのまま使います。 人間が考えたものは、思ったより推測されます。

アプリ側のアカウントも見ます。開発中に作った test@example.com / test のようなユーザーは、外に出す前に消します。

bash
$ mysql -u hitokoto -p hitokoto -e "SELECT id, email, created_at FROM users;"
+----+---------------------+---------------------+
| id | email               | created_at          |
+----+---------------------+---------------------+
|  1 | test@example.com    | 2026-09-10 11:02:31 |
|  2 | a@a                 | 2026-09-10 11:40:08 |
+----+---------------------+---------------------+

この2件は消します。 パスワード保存の回で書いたとおり、パスワードはハッシュで入っているので中身は読めませんが、test のような短いパスワードは総当たりで通ります。

3. デバッグ用の表示が残っていないか

bash
$ grep -rn "console\.log" ~/hitokoto/server/src ~/hitokoto/client/src | wc -l
$ grep -rn "console\.log" ~/hitokoto/server/src | head -20

全部消す必要はありません。 見るのは「何を出しているか」だけです。

  • console.log('server started') … 問題ありません
  • console.log(req.body) … パスワードがそのままログに残ります。消します
  • console.log(user) … ハッシュ済みパスワードの列ごと出ます。消します

ログに残ったパスワードは、暗号化されていない場所に置いたパスワードです。 データベースだけ丁寧にハッシュしても、隣のログに平文で置いてあれば意味がありません。

4. エラーの中身を外に返していないか

開発中は、エラーの詳細が画面に出たほうが便利です。そのまま出すと、攻撃者に地図を渡します。

bash
$ grep -rn "err.stack\|error.stack\|res.json(err" ~/hitokoto/server/src

出てきたら直します。ログには全部書いて、レスポンスには何も書かない、が基本の形です。

// server/src/app.js の一番最後(すべてのルートより後ろ)
app.use((err, req, res, next) => {
  // 手元のログには全部残す
  console.error(err);

  // 外へ返すのは「番号」と「短い文」だけ
  const status = err.status || 500;
  res.status(status).json({
    error: status === 500 ? 'Internal Server Error' : err.message,
  });
});

500(こちらの不具合)のときだけ、中身を伏せます。 400番台は「あなたの入力がこう間違っている」という利用者に必要な情報なので、返して構いません。

確かめます。わざと壊れるURLを叩きます。

bash
$ curl -i http://localhost:3000/api/books/abc
HTTP/1.1 500 Internal Server Error
Content-Type: application/json; charset=utf-8

{"error":"Internal Server Error"}

ファイルのパスもSQLも出ていません。 これが正しい状態です。VMのログのほうには全部出ています。

bash
$ journalctl -u hitokoto -n 20 --no-pager

5〜 まとめて1本のスクリプトにする

ここまでを毎回手で打つと、そのうち打たなくなります。 1本にします。

bash
$ mkdir -p ~/hitokoto/scripts
$ nano ~/hitokoto/scripts/preflight.sh
bash
#!/bin/bash
  # 公開前の点検。1つでも赤が出たら出さない。
  cd "$(dirname "$0")/.." || exit 1

  ng=0
  check() {           # check "名前" "コマンド"  … 出力が空なら合格
    local name="$1"; shift
    local out
    out=$("$@" 2>/dev/null)
    if [ -z "$out" ]; then
      echo "  OK   $name"
    else
      echo "  NG   $name"
      echo "$out" | sed 's/^/       /'
      ng=$((ng+1))
    fi
  }

  echo "== 公開前チェック =="
  check ".env が追跡されていない"  bash -c "git ls-files | grep -E '(^|/)\.env'"
  check ".env が履歴にも無い"      bash -c "git log --all --name-only --pretty=format: | sort -u | grep -E '(^|/)\.env'"
  check "コードに直書きの秘密が無い" bash -c "git grep -nE \"(password|secret|api[_-]?key)\\s*[:=]\\s*['\\\"][^'\\\"]{6,}\" -- ':!*.md'"
  check "req.body をログに出していない" bash -c "grep -rn 'console.log(req' server/src"
  check "スタックトレースを返していない" bash -c "grep -rn 'err.stack' server/src"

  echo "== バックアップ =="
  if [ -n "$(find ~/backup -name 'hitokoto-*.sql*' -mtime -1 2>/dev/null)" ]; then
    echo "  OK   24時間以内のバックアップがある"
  else
    echo "  NG   24時間以内のバックアップが無い"
    ng=$((ng+1))
  fi

  echo
  if [ "$ng" -eq 0 ]; then echo "全部OK"; else echo "NGが ${ng} 件。出さない。"; exit 1; fi
bash
$ chmod +x ~/hitokoto/scripts/preflight.sh
$ ~/hitokoto/scripts/preflight.sh
== 公開前チェック ==
  OK   .env が追跡されていない
  OK   .env が履歴にも無い
  OK   コードに直書きの秘密が無い
  NG   req.body をログに出していない
       server/src/routes/auth.js:22:  console.log(req.body);
  OK   スタックトレースを返していない
== バックアップ ==
  NG   24時間以内のバックアップが無い

NGが 2 件。出さない。

赤が出ました。これでいいのです。 目で見ていたら、この2つとも見落としていました。

[スクリーンショット: 02_preflight実行結果.png] preflight.sh を実行して、NG が出ている画面を撮ってください。

console.log(req.body) を消して、バックアップは次の節で作ります。「全部OK」が出るまで、公開しません。

置き場所は3つある

点検が終わったら、どこに置くかです。3つあります。

① VPSを1台借りる② 画面とAPIを分ける③ 自宅のVMのまま
形1台のLinuxに全部入れる(いまのVMと同じ)dist/ は静的ホスティング、APIはどこかで動かす何もしない
インターネットから届くか届く届く届かない
独自ドメイン使える使える使えない
これまでの知識そのまま全部使えるnginx の出番が減るそのまま
お金かかる(金額は提供元次第)画面側は無料の範囲がある。APIは条件次第かからない
向いている人仕組みを理解したい人。この記事の想定画面が主役で、APIが小さい人まだ人に見せる予定が無い人
落とし穴止め忘れると課金が続く。落ちたら自分で直すクッキーが別ドメインになり、ログインが通らなくなりがち動いているのは自分だけ

この記事は①を想定して手順を書きます。 理由は、いままでやってきたこと(nginx・systemd・MySQL・ufw)がそのまま使えるからです。VPSは「インターネットから届くVM」で、やることはほとんど変わりません。

②は静的ホスティングの回でやった形です。画面側は本当に無料で出せますが、hitokoto はログインがあるので、クッキーの扱いで一段難しくなります(画面が a.example.com、APIが b.example.com になると、クッキーが送られません)。最初の1本には向きません。

③でも構いません。この記事の手順は、③のままでも最後まで実行できます。 変わるのは「外から届くかどうか」だけで、設定の中身は同じです。

VPSを借りるなら、クラウド料金の回を先に読んでください。 止め忘れは、必ず起きます。 上限と通知を先に作ってから借りてください。

以降、「サーバー」と書いたら、VPSでも自宅のVMでも同じことです。

① の VPS は、いまの VM と同じ「1 台の Linux に全部入れる」形なので、ここまでの手順がそのまま使えます。国産の例ではさくらのVPSが全プラン SSD・初期費用無料の定額制で、クレジットカード払いなら 2 週間無料で試せます(2026-11 時点、最低利用期間は 3 ヶ月、解約しないと自動で本登録)。ただし公式 FAQ ではバックアップ機能が標準・オプションともに無いとされているので、次の節でやる mysqldump と復元を自分で回す前提になります。

本番の設定を、開発の設定と分ける

同じコードを、違う設定で動かします。 ここを分けないまま出すと、動くけれど危ない状態になります。

NODE_ENV=production が何をするか

「おまじない」ではありません。実際に挙動が変わります。

  • Express がエラー画面にスタックトレースを出さなくなる
  • テンプレートやルーティングの一部がキャッシュされる(速くなる)
  • 多くのライブラリが、開発用の警告と検査を止める

確認します。

bash
$ sudo systemctl show hitokoto -p Environment
Environment=NODE_ENV=production

サービスの定義に入れます。

bash
$ sudo nano /etc/systemd/system/hitokoto.service
[Service]
Environment=NODE_ENV=production
EnvironmentFile=/home/ubuntu/hitokoto/server/.env
WorkingDirectory=/home/ubuntu/hitokoto/server
ExecStart=/usr/bin/node src/index.js
bash
$ sudo systemctl daemon-reload
$ sudo systemctl restart hitokoto

EnvironmentFile に指定したファイルは、systemd が読みます。 export は書きません。 KEY=value を1行ずつ書くだけです。export DB_PASSWORD=xxx と書くと、 export を含む変な名前の変数になります(これで1時間溶かしました)。

.env を本番用にする

開発用の .env をそのままコピーしません。 中身を1つずつ決め直します。

変数開発本番
NODE_ENVdevelopmentproduction
DB_PASSWORD適当でよかったopenssl rand で作り直す
SESSION_SECRET適当でよかったopenssl rand で作り直す
COOKIE_SECUREfalsetrue
CLIENT_ORIGINhttp://localhost:5173本番のURL

ファイルの権限も見ます。中にパスワードが書いてあります。

bash
$ chmod 600 ~/hitokoto/server/.env
$ ls -l ~/hitokoto/server/.env
-rw------- 1 ubuntu ubuntu 214 Sep 14 09:12 /home/ubuntu/hitokoto/server/.env

-rw-------(600)です。パーミッションの回で見た読み方どおり、本人以外は読めません。

セッションのクッキー — ここが一番ハマる

hitokoto のログインはセッションです。クッキーの設定を、本番用に変えます。

// server/src/app.js
const isProd = process.env.NODE_ENV === 'production';

app.set('trust proxy', 1);   // ← これが無いと、後述の理由で詰みます

app.use(session({
  name: 'hitokoto.sid',
  secret: process.env.SESSION_SECRET,
  resave: false,
  saveUninitialized: false,
  cookie: {
    httpOnly: true,                    // JavaScriptから読めなくする
    secure: isProd,                    // httpsのときだけ送る
    sameSite: 'lax',                   // 他サイトからの遷移で送るかどうか
    maxAge: 1000 * 60 * 60 * 24 * 7,   // 7日
  },
}));

4つとも意味があります。

設定何をするか外すとどうなるか
httpOnly: trueJavaScript から document.cookie で読めなくするスクリプトを1つ差し込まれたら、セッションを丸ごと盗まれる
secure: truehttps のときだけブラウザが送るhttp:// で1回でも開かれたら、セッションIDが平文で流れる
sameSite: 'lax'他サイトから来た通信では送らない(トップレベルの遷移は除く)他人のサイトに置かれたフォームから、あなたの権限で操作される
maxAge期限を決める一度ログインしたら永久に有効になる

app.set('trust proxy', 1) を忘れると、本番でログインできなくなります。

理由はこうです。ブラウザ ↔ nginx は https ですが、nginx ↔ Node は http://localhost:3000 です(リバースプロキシの回でそう組みました)。

Express から見えているのは後半だけなので、secure: true のクッキーを「いまは http だから」と発行しません。 ログインは成功しているのに、クッキーが返らず、次のリクエストでまたログイン画面。エラーは1つも出ません。

trust proxy を有効にすると、Express は nginx が付ける X-Forwarded-Proto ヘッダを信用して、「元は https だった」と判断します。nginx 側でそのヘッダを送っているかも確認します。

location /api/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host              $host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;   # ← これ
}

セッションの置き場所

もう1つ。開発中のセッションは、Node のメモリの中にあります。

つまり、デプロイしてサービスを再起動するたびに、全員ログアウトします。 自分1人なら我慢できますが、この後で「デプロイを1コマンドにする」ので、毎回起きます。

置き場所を外に出します。Redis の回で入れたものが、そのまま使えます。

bash
$ grep -n "MemoryStore\|connect-redis\|store:" ~/hitokoto/server/src/app.js

store: の指定が無ければ、メモリです。起動時に警告も出ています。

bash
$ journalctl -u hitokoto | grep -i "memorystore"
Warning: connect.session() MemoryStore is not designed for a production environment

ライブラリが「本番向けではない」と言っています。 読んでいなかっただけです。

山場 — バックアップと復元を、公開より先にやる

ここがこの回で一番大事な節です。

バックアップは、取った時点では存在しません。戻せて初めて存在します。

「毎日 mysqldump を回しているから安心」という状態で、実際に戻したことが一度も無い人はたくさんいます。そして、その .sql が0バイトだったり、文字コードが壊れていたり、必要なテーブルが入っていなかったりします。気づくのは、消えた日です。

だから、いま、わざと消して、戻します。

取る

bash
$ mkdir -p ~/backup
$ mysqldump -u hitokoto -p \
    --single-transaction \
    --default-character-set=utf8mb4 \
    hitokoto > ~/backup/hitokoto-$(date +%F-%H%M).sql

オプションの意味です。意味の分からないオプションを付けないでください。

オプション何をするか
--single-transactionテーブルをロックせずに、ある瞬間の一貫した状態を書き出す。動いたままバックアップできる
--default-character-set=utf8mb4日本語が化けないようにする。省略すると環境によって壊れる

取れたことを確かめる(ここを飛ばさない)

ファイルができた、では確認になりません。

bash
$ ls -lh ~/backup/
-rw-rw-r-- 1 ubuntu ubuntu 14K Sep 14 09:31 hitokoto-2026-09-14-0931.sql

0バイトではありません。 中身も見ます。

bash
$ grep -c "INSERT INTO" ~/backup/hitokoto-2026-09-14-0931.sql
$ grep "CREATE TABLE" ~/backup/hitokoto-2026-09-14-0931.sql
3
CREATE TABLE `books` (
CREATE TABLE `knex_migrations` (
CREATE TABLE `quotes` (
CREATE TABLE `users` (

テーブルが4つ、INSERT が3つ。 想定どおりです。ついでに、いまの件数を控えます。

bash
$ mysql -u hitokoto -p hitokoto -e "SELECT COUNT(*) AS books FROM books; SELECT COUNT(*) AS quotes FROM quotes;"
+-------+
| books |
+-------+
|     6 |
+-------+
+--------+
| quotes |
+--------+
|     11 |
+--------+

6 と 11。この2つの数字を覚えておきます。

消す

ここから先は、スナップショットを取った人だけやってください。 この記事の最初で 公開前 を取りました。取っていないなら、戻って取ってきてください。

bash
$ mysql -u hitokoto -p -e "DROP DATABASE hitokoto;"

確認は出ません。一瞬で消えます。

ブラウザで hitokoto を開きます。500 が返ります。 サーバーのログはこうです。

bash
$ journalctl -u hitokoto -n 5 --no-pager
Error: ER_BAD_DB_ERROR: Unknown database 'hitokoto'

この画面を見ておくことに意味があります。 本番で初めて見ると、頭が真っ白になります。練習で1回見ておけば、「ああ、あれか」で済みます。

戻す

3手です。

bash
$ mysql -u hitokoto -p -e "CREATE DATABASE hitokoto CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;"
$ mysql -u hitokoto -p hitokoto < ~/backup/hitokoto-2026-09-14-0931.sql
$ sudo systemctl restart hitokoto

CHARACTER SET utf8mb4 を必ず付けてください。 付けないと、サーバーの既定の文字コードで作られます。ダンプの中身は utf8mb4 なので、戻せたように見えて日本語だけ化けます。

確かめます。さっき控えた数字と比べます。

bash
$ mysql -u hitokoto -p hitokoto -e "SELECT COUNT(*) AS books FROM books; SELECT COUNT(*) AS quotes FROM quotes; SELECT title FROM books LIMIT 3;"
+-------+
| books |
+-------+
|     6 |
+-------+
+--------+
| quotes |
+--------+
|     11 |
+--------+
+--------------------------+
| title                    |
+--------------------------+
| 走れメロス               |
| 夜と霧                   |
| 思考の整理学             |
+--------------------------+

6 と 11 に戻りました。日本語も化けていません。

最後に、ブラウザで実際にログインして、自分の一文が表示されるところまで見ます。SQLの件数が合っていても、アプリが動くとは限りません。

[スクリーンショット: 03_復元後の一覧.png] DROP して復元したあとの hitokoto の一覧画面を、ブラウザで撮ってください。

毎日取る、そして古いものを消す

手で打つのは今日だけです。

bash
$ nano ~/hitokoto/scripts/backup.sh
bash
#!/bin/bash
  set -euo pipefail

  DIR=~/backup
  KEEP=7                       # 7世代だけ残す
  mkdir -p "$DIR"

  FILE="$DIR/hitokoto-$(date +%F-%H%M).sql"
  mysqldump --defaults-file=~/.my.cnf \
    --single-transaction --default-character-set=utf8mb4 \
    hitokoto > "$FILE"

  # 0バイトなら失敗とみなす(成功したことにしない)
  if [ ! -s "$FILE" ]; then
    echo "バックアップが空です: $FILE" >&2
    exit 1
  fi

  gzip -f "$FILE"
  ls -1t "$DIR"/hitokoto-*.sql.gz | tail -n +$((KEEP+1)) | xargs -r rm --
  echo "OK $FILE.gz"

パスワードをスクリプトに書かないために、設定ファイルに置きます。

bash
$ nano ~/.my.cnf
$ chmod 600 ~/.my.cnf
[client]
user=hitokoto
password=ここに本番のパスワード

cron に載せます。

bash
$ crontab -e
15 4 * * * /home/ubuntu/hitokoto/scripts/backup.sh >> /home/ubuntu/backup/backup.log 2>&1

毎日 4:15 に走ります。 翌日、ログを見ます。

bash
$ tail -3 ~/backup/backup.log

大事なことを3つ。

  1. set -euo pipefail を必ず書く。 これが無いと、mysqldump が失敗しても空のファイルが残って「成功」になります
  2. -s(中身があるか)で確かめる。 ファイルの存在は成功の証明になりません
  3. バックアップを、同じサーバーに置いたままにしない。 サーバーごと壊れたら、バックアップも一緒に消えます。別の場所へ1本コピーするのを、後で足してください(Windows へ scp で持ってくるだけでも、無いよりずっとましです)

そして一番忘れられること。

月に1回、復元を試してください。

いまやったこと(消して、戻して、件数を比べる)を、カレンダーに入れます。やらないバックアップは、無いのと同じです。

名前を付けて、暗号化する

ここは独自ドメインを持っている人と、持っていない人で分かれます。 どちらでも構いません。

持っている場合 — Aレコードとcertbot

まず、ドメインがサーバーを指すようにします。 DNSレコードの回で「引く」ことはやりました。今回は書きます。

ドメインを買った会社の管理画面で、Aレコードを2つ作ります。

ホスト名種別値
@(ドメインそのもの)AVPSのIPアドレス
wwwA同じIPアドレス

反映を確認します。VMの中から引きます。

bash
$ dig +short example.com A
$ dig +short www.example.com A

自分のVPSのIPが返れば成功です。 返らないときは、TTLの分だけ待ちます。ここで焦って設定を何度も書き換えると、余計に分からなくなります。

次に証明書です。

bash
$ sudo apt update
$ sudo apt install certbot python3-certbot-nginx
$ sudo certbot --nginx -d example.com -d www.example.com

certbot は「本当にこのドメインの持ち主か」を確かめるために、80番ポート経由で確認を取りに来ます。 そのため、

  • 80番が開いていること(sudo ufw status で確認)
  • DNSがすでにこのサーバーを指していること

の2つが先です。順番が逆だと必ず失敗します。

成功すると、nginx の設定が書き換えられます。 どう変わったか、必ず自分で見てください。

bash
$ sudo nginx -T | grep -A2 "listen 443\|return 301"

そして、httpsの回でやったのと同じ確認をします。

証明書を入れただけでは、http のままでも見えます。

bash
$ curl -I http://example.com/
HTTP/1.1 301 Moved Permanently
Location: https://example.com/

301 で https に飛んでいるのが正解です。 200 OK が返ってきたら、暗号化なしのページが今も配られています。 certbot はリダイレクトを設定してくれますが、選択肢を聞かれたときに間違えると入りません。 自分で確かめてください。

更新も確認します。証明書の有効期間は短いので、自動で更新されないと3か月ほどでサイトが開かなくなります。

bash
$ sudo certbot renew --dry-run
$ systemctl list-timers | grep certbot

--dry-run は本番の更新をせずに、更新の練習だけするオプションです。ここで成功しておけば、当日も動きます。

持っていない場合 — VMの中で「形だけ」確かめる

ドメインが無くても、https の形は作れます。 自分で証明書を作ります。

nip.io のような「IPをドメインに見せる」サービスは、ここでは使いません。 便利ですが、外部サービスに依存するぶん、動かなかったときに原因が分かりません。 VMの中で完結する方法でやります。

bash
$ sudo mkdir -p /etc/ssl/hitokoto
$ sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
    -keyout /etc/ssl/hitokoto/self.key \
    -out    /etc/ssl/hitokoto/self.crt \
    -subj "/CN=hitokoto.local"

nginx に読ませます。

server {
    listen 443 ssl;
    server_name hitokoto.local;

    ssl_certificate     /etc/ssl/hitokoto/self.crt;
    ssl_certificate_key /etc/ssl/hitokoto/self.key;

    root /var/www/hitokoto;
    index index.html;
    location / { try_files $uri $uri/ /index.html; }

    location /api/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host              $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
bash
$ sudo nginx -t && sudo systemctl reload nginx

Windows のブラウザから https://192.168.226.50/ を開くと、警告が出ます。

この警告が出るのが、正しい動作です。

証明書には2つの仕事があります。

仕事自己署名証明書
通信を暗号化するできる(中身は本物の証明書と同じ強さ)
相手が本物だと証明するできない(自分で自分に「本物です」と書いただけ)

ブラウザが怒っているのは後者だけです。だから、警告を無視して進めば、通信そのものは暗号化されています。

ここで、セッションのクッキーが secure: true でちゃんと発行されるかを確かめられます。これが、この節の本当の目的です。

Windows のブラウザで F12 →[アプリケーション]→[Cookie]を開いて、hitokoto.sid の Secure に印が付いているか見てください。開発者ツールの回で開いた画面です。

付いていなければ、trust proxy を疑ってください。

ドメインをまだ持っていない場合、取得先の例としてXServerドメインがあります。取得・更新・移管の表示価格以外に維持調整費やオプション料金がかからない料金体系で、2026-11 時点の価格一覧では .com が通常取得 1,721 円・更新 1,721 円(税込)、はじめて使う人向けに対象ドメインのいずれか 1 つが取得 0 円になるキャンペーンがあります(終了日の記載なし)。DNS 設定と Whois 代理公開が標準で付いているので、この節の A レコードもそこで書くことになります。

デプロイを、手順書ではなく1コマンドにする

いま、コードを直してから反映するまでにやることは、これだけあります。

  1. git pull
  2. サーバー側の npm ci
  3. マイグレーション
  4. 画面側の npm ci と npm run build
  5. dist/ を nginx の場所へコピー
  6. systemctl restart hitokoto
  7. 動いているか確認

手順書に書いても駄目です。 疲れているときに、4を飛ばします。飛ばした結果、「なぜか反映されない」で30分溶かします。

3回打ったコマンドはスクリプトにする。 第1段階の総まとめで書いたとおりです。

bash
$ nano ~/hitokoto/scripts/deploy.sh
$ chmod +x ~/hitokoto/scripts/deploy.sh
bash
#!/bin/bash
  set -euo pipefail          # 途中で失敗したら、そこで止まる

  cd ~/hitokoto
  PREV=$(git rev-parse HEAD)  # 戻れるように、いまの位置を控える
  echo "現在: $PREV"

  # 0) 先にバックアップ(マイグレーションで壊す可能性があるため)
  ~/hitokoto/scripts/backup.sh

  # 1) 取ってくる
  git pull --ff-only

  # 2) サーバー側
  cd ~/hitokoto/server
  npm ci --omit=dev
  npx knex migrate:latest

  # 3) 画面側
  cd ~/hitokoto/client
  npm ci
  npm run build

  # 4) 配る場所へ置く
  sudo rsync -a --delete dist/ /var/www/hitokoto/

  # 5) 入れ替える
  sudo systemctl restart hitokoto

  # 6) 生きているか確かめる(ここが無いスクリプトは信用しない)
  sleep 2
  if curl -fsS http://localhost:3000/api/health > /dev/null; then
    echo "デプロイ成功: $(git rev-parse --short HEAD)"
  else
    echo "ヘルスチェック失敗。戻します。" >&2
    git reset --hard "$PREV"
    cd ~/hitokoto/server && npm ci --omit=dev
    cd ~/hitokoto/client && npm ci && npm run build   # 画面側も前の版で作り直す
    sudo rsync -a --delete dist/ /var/www/hitokoto/
    # 実行済みのマイグレーションはこれでは戻らない。DBを戻すなら 0) のバックアップから
    sudo systemctl restart hitokoto
    echo "$PREV に戻しました。" >&2
    exit 1
  fi

大事なのは最後の6です。

「コマンドが全部通った」は「動いている」ではありません。

systemctl restart は、起動に失敗しても一瞬は成功したように見えます。 実際に叩いて 200 が返るまでが、デプロイです。ヘルスチェック用のURLは、返事をするだけの小さなものを1本足しておきます。

// server/src/routes/health.js
router.get('/health', async (req, res) => {
  try {
    await knex.raw('SELECT 1');          // DBまで届くか見る
    res.json({ status: 'ok' });
  } catch (e) {
    res.status(503).json({ status: 'db_down' });
  }
});

DBまで見るかどうかは、決めの問題です。 見ると「DBが落ちているのにアプリは生きている」を検知できますが、DBの一時的な詰まりで「アプリが落ちた」と誤検知もします。hitokoto の規模なら、見るほうが得です。

使い方は1行です。

bash
$ ~/hitokoto/scripts/deploy.sh

GitHub Actions に載せる形

CI/CDの回で書いたとおり、GitHub の実行環境は、NATの内側のVMには到達できません。 VPSに置いた場合は届くので、こう書けます。

name: deploy
on:
  workflow_dispatch:          # ← 手で押したときだけ。pushでは動かさない

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: サーバーで deploy.sh を実行する
        uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.DEPLOY_HOST }}
          username: ${{ secrets.DEPLOY_USER }}
          key: ${{ secrets.DEPLOY_KEY }}
          script: /home/ubuntu/hitokoto/scripts/deploy.sh

on: workflow_dispatch にしています。 push のたびに自動で本番へ出す形は、テストが揃ってからです。いまは「ボタンを押したら、抜けなく実行される」だけで十分な価値があります。

自宅のVMのままなら、セルフホストランナーを使うか、VMの中で deploy.sh を打つかです。後者で全く問題ありません。 スクリプトになっていること自体が本体で、どこから起動するかは後から変えられます。

落ちたことに、気づけるようにする

最後です。「落ちない仕組み」ではなく「落ちたと分かる仕組み」を作ります。落ちるのは前提です。

① 勝手に起き上がらせる

bash
$ sudo nano /etc/systemd/system/hitokoto.service
[Service]
Restart=always
RestartSec=5
StartLimitBurst=5
StartLimitIntervalSec=60
bash
$ sudo systemctl daemon-reload
$ sudo systemctl restart hitokoto

Restart=always は、プロセスが死んだら5秒後に起こし直します。 systemd の回でやった enable(起動時に開始)とは別の話です。

確かめます。わざと殺します。

bash
$ sudo systemctl show hitokoto -p MainPID
$ sudo kill -9 <出てきた番号>
$ sleep 6
$ systemctl status hitokoto --no-pager | head -5
● hitokoto.service - hitokoto API
     Active: active (running) since Mon 2026-09-14 10:22:41 JST; 3s ago

3秒前に起動しています。 起き上がりました。

Restart=always には副作用があります。 落ちたことが、見えなくなります。 1日に40回死んで40回復活していても、status は active (running) です。 だから次の②が要ります。

StartLimitBurst は「60秒に5回落ちたら、もう起こさない」という指定です。壊れたまま無限に再起動し続けて、ログとCPUを食い潰すのを止めます。

② 回数を見る

bash
$ journalctl -u hitokoto --since "24 hours ago" | grep -c "Started"

1〜2回なら、自分がデプロイした分です。 20回なら、何かが繰り返し落ちています。 ここを見に行く習慣だけで、だいぶ違います。

nginx 側も同じです。

bash
$ sudo grep -c " 502 " /var/log/nginx/access.log
$ sudo tail -20 /var/log/nginx/error.log

502 は「nginx は生きているが、後ろに繋がらなかった」でした(障害対応の回)。502 の数は、そのままアプリが落ちていた回数に近い数字になります。

③ 外から叩いて、駄目なら知らせる

ここまでは全部サーバーの中から見ています。 サーバーごと落ちたら、誰も気づきません。外から叩く仕組みが要ります。

最低限はこれで足ります。

bash
$ nano ~/hitokoto/scripts/uptime-check.sh
$ chmod +x ~/hitokoto/scripts/uptime-check.sh
bash
#!/bin/bash
  URL="https://example.com/api/health"
  STATE=~/.hitokoto-uptime

  if curl -fsS --max-time 10 "$URL" > /dev/null; then
    if [ -f "$STATE" ]; then
      echo "$(date '+%F %T') 復旧しました" >> ~/uptime.log
      rm -f "$STATE"
    fi
  else
    if [ ! -f "$STATE" ]; then          # 落ちた瞬間だけ1回だけ知らせる
      echo "$(date '+%F %T') 落ちています: $URL" >> ~/uptime.log
      touch "$STATE"
    fi
  fi
*/5 * * * * /home/ubuntu/hitokoto/scripts/uptime-check.sh

「落ちた瞬間だけ1回」にしているのが要点です。 毎回知らせると、5分おきに同じ通知が来て、そのうち全部無視するようになります。 無視される通知は、無い通知と同じです。

このスクリプトを、監視される側と同じサーバーに置かないでください。 サーバーが落ちたら、この監視も一緒に落ちます。 Windows のタスクスケジューラで動かすか、 監視SaaSの回で見た外部サービスを使ってください。 無料の枠で「1つのURLを5分おき」なら、たいてい足ります。

Prometheus と Grafana は監視の回で立てました。そこまで使うかは、あとで決めればいい話です。 いまは、落ちたことに気づけるだけで、ゼロから大きく前進しています。

いまは要らないものを、はっきり決めておく

ここまで読んで、足りない気がしているはずです。ロードバランサも、CDNも、Kubernetes も、Terraform も、この記事には出てきません。

要りません。

使わないものいつ考えるか
Kubernetes1台で捌けなくなってから。 クラスタの回で組んだとおり、運用のコストは1台とは別物です
CDN画像や配信量で困ってから。 キャッシュの回の知識は、困ったときに使えばいい
ロードバランサ1台が足りなくなってから(OSIの回)
マイクロサービス当分。 モノリスの回に書いたとおり、いまは1つのままが正解です
Terraformサーバーが3台を超えてから(Terraform の回)

これらは知らないから使わないのではありません。全部やってきた上で、いまの規模には合わないから使わないのです。その判断ができることが、この段階の到達点です。

利用者が1人のサービスにKubernetesを入れると、Kubernetesの運用だけが仕事になります。

運用に入る、とはどういうことか

公開したら終わり、ではありません。むしろここからが長いです。

そして、運用とは「動かし続けること」ではなく「直し続けること」です。

最初の利用者は、自分

hitokoto を、1週間、本気で使ってください。 実際に読んだ本を登録して、実際に引用を書き写します。

これをやらないと、直すべき場所が分かりません。 作っている間は「動くか」しか見ていないので、使い勝手の話が1つも見えていません。

1週間使うと、必ず不満が出ます。実際に出たのはこうでした。

不満直しかた
本を登録してから引用を書くのが2画面で面倒登録画面に引用の入力欄を1つ足す
引用が増えると探せない検索を足す(全文検索の回まで要らない。LIKE で十分)
スマホで打ちにくいレスポンシブの回の内容を、自分のアプリでやる
間違えて登録した本が消せない削除を足す。作るときに後回しにした場所です

1つだけ直して、デプロイする

全部直そうとしないでください。 いま一番困っている1つを選んで、直して、deploy.sh を打つ。ここまでやって、この回は終わりです。

bash
$ cd ~/hitokoto
$ git switch -c fix-delete-book
$ # 直す
$ git add -A && git commit -m "登録した本を削除できるようにする"
$ git switch main && git merge fix-delete-book
$ ~/hitokoto/scripts/deploy.sh
現在: 8f3c1d2...
OK /home/ubuntu/backup/hitokoto-2026-09-21-2140.sql.gz
...
デプロイ成功: a71b409

この一連の流れ(使う → 不満が出る → 直す → 出す)が回った時点で、あなたは「運用している」状態です。

作って終わりのものと、運用しているものの差は、技術ではなくこのループがあるかどうかです。

つまずいたところ

① ログインできるのに、次の画面でまたログイン画面

https にして secure: true にした直後です。エラーは1つも出ません。 ログインのAPIは 200 を返し、画面は遷移し、そこで「ログインしてください」に戻ります。

原因は app.set('trust proxy', 1) の書き忘れでした。Express は自分が http で受けていると思っているので、secure なクッキーを発行しません。 発行していないので、ブラウザは何も送りません。「クッキーが無い=未ログイン」で、正しく動いています。

見つけ方は、F12 の[Cookie]を開いてそもそも hitokoto.sid が存在しないと気づいたことでした。「送られていない」ではなく「作られていない」。ここを取り違えると、ずっと nginx の設定を疑い続けます。

② 復元したら、日本語だけ「?????」になった

CREATE DATABASE hitokoto; で作ってから流し込んだときです。件数は完全に合っていました。 一覧も出ました。タイトルだけ全部 ? でした。

原因は、データベースの文字コードが utf8mb4 ではない状態で作られていたことです。CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci を付けて作り直したら直りました。

学びは「件数が合っている=復元できている、ではない」です。必ず中身を1行見てください。 数字だけ見ていたら、そのまま公開していました。

③ dist/ の中に、APIキーが入っていた

preflight.sh を書いている途中で見つけました。開発中に「後で消す」と思って VITE_ADMIN_TOKEN を置いたのを忘れていました。

bash
$ grep -o "VITE_ADMIN_TOKEN[^\"]*" dist/assets/*.js

そのまま出てきました。 dist/ はブラウザに配るファイルなので、これは「公開されている」と同じです。

画面側の環境変数は、隠す道具ではありません。 隠したいものは、必ずサーバー側に置いて、APIごしに使います。

④ certbot が「ドメインの確認に失敗しました」で止まる

2回失敗しました。原因は別々でした。

1回目は DNS がまだ反映されていなかった。dig +short が古いIPを返している状態で実行していました。待つしかありません。

2回目は ufw で 80番を閉じていたことです。「https にするんだから 80 は要らない」と思って閉じていました。確認は 80 番で来ます。 そして、80 番はリダイレクト用に必要です。閉じるものではありませんでした。

⑤ deploy.sh が途中で失敗して、中途半端な状態になった

最初に書いた deploy.sh には set -e がありませんでした。マイグレーションが失敗したのに、その先の systemctl restart まで進みました。

結果、新しいコードが、古いテーブルを触りに行って 500。ログを見るまで何が起きたか分かりませんでした。

set -euo pipefail を足して、ヘルスチェックで失敗したら前のコミットに戻すところまで書いて、やっと安心して打てるようになりました。「途中で止まる」ことは、失敗ではなく機能です。

まとめ — 理解できたこと

  • 「公開する」は4つの別の仕事だった。届く場所に置く / 名前を付ける / 暗号化する / 落ちても戻せる。ボタンは無い
  • やる順番は④が先。①②③は失敗しても誰も困らないが、④の失敗はデータが消える
  • バックアップは、戻せて初めて存在する。 mysqldump を取っただけの状態は、取ったつもりでしかない。わざと消して戻すまでが1セット
  • 件数が合っていても復元できたとは限らない。 文字コードで日本語だけ壊れる。必ず中身を1行見る
  • 開発の設定のまま出すと、黙って壊れる場所がある。 secure なクッキーは nginx 越しだと発行されず、エラーは1つも出ない(trust proxy)
  • VITE_ の環境変数は dist/ に焼き込まれる。 画面側は隠し場所ではない
  • Restart=always は落ちたことを見えなくする。 だから回数を見る仕組みと、外から叩く仕組みが要る
  • Kubernetes も CDN も、いまは要らない。 全部やった上で「合わない」と判断できることが、この段階の到達点
  • 運用とは、直し続けること。 最初の利用者は自分で、使わないと不満は出ない

そして、点検スクリプト・バックアップスクリプト・デプロイスクリプトの3本が手元に残りました。次に何を作っても、この3本はほぼそのまま使い回せます。

参考リンク


次に読む

この記事は 【第9段階】作品を1つ完成させる の 4 / 10 本目です。

記事
← 前の記事「動く」と「使える」の差は4つの状態 — Reactの画面
→ 次の記事他人は5分しか見ない — READMEと技術選定

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次