開発でプレビューして本番に昇格

2 つの環境とブランチの対応関係

ブランチ	サイト	検索エンジンによるインデックス
main	https://jenksguo.xyz	はい
dev	https://dev.jenksguo.xyz	いいえ (noindex)

各ブランチへの push ごとに CI が実行されます。変更されたエントリをすべての言語に翻訳し、ビルドして、そのブランチのサイトにデプロイします。管理者による書き込みは既定で main に対して行われます。代わりにステージするには、--branch dev（CLI）または "branch": "dev"（REST/MCP）を渡します。

1. dev で変更を行う

jenks admin put content/corpus/projects/smart-energy-meter.md smart-energy-meter.md \
  -m "Smart energy meter: add thesis link" --branch dev

必要なだけ繰り返します。各書き込みは dev 上の 1 コミットになります。

2. デプロイを待つ

jenks admin deploys --branch dev

dev の最新の実行が成功するまで待ちます。多くのエントリが変更された場合は、翻訳に少し時間がかかります。

3. プレビューを確認する

変更したページを https://dev.jenksguo.xyz と、少なくとも 1 つの翻訳版で開きます。例: https://dev.jenksguo.xyz/ja/projects/smart-energy-meter。変更点に触れる質問を開発用アシスタントに投げて、ボットが取り込んでいるかを確認します。

jenks ask "What was Jenks's final-year project?" --api https://dev.jenksguo.xyz

4. 昇格する

jenks admin promote

これは dev を main にマージし、本番デプロイをトリガーします。jenks admin deploys をもう一度実行して完了を確認し、https://jenksguo.xyz をチェックします。

問題がある場合

• 昇格前: dev に別のコミットで修正するか、git で変更をリバートします。
• 昇格後: 修正を直接 main にコミットするか、dev で修正して再度昇格します。git はすべてのバージョンを保持するため、以前のファイルを復元することは常に可能です。
• 昇格時のマージコンフリクト: 誰かが同じファイルを main で直接変更しています。git で dev を main に追随させ、解決してから再度昇格します。