◉ANTIGRAVITY LABEN
記事一覧/Antigravity 基本
◉ Antigravity 基本/2026-06-19中級

Antigravity 2.0 への移行で自動運用を止めないために — 並走期間とロールバックの設計

Antigravity 2.0 への移行で既存の自動運用を止めないための、並走期間の置き方とロールバック経路の設計をまとめました。出力の同値確認とバージョン固定まで、個人開発の実作業に当てはめて整理しています。

antigravity476migration10automation55rollbackworkflow41

✦ プレミアム記事

6月18日に Gemini CLI と Gemini Code Assist の IDE 拡張がリクエスト受付を終え、移行先が Antigravity に一本化されました。エディタを手で触っているだけなら、新しい画面に慣れる時間の問題で済みます。

問題は、CLI を定期実行に組み込んでいる場合です。私自身、4つのブログサイトの記事生成とデプロイを毎日スケジュールで回しているため、停止日が決まっている移行は「いつ新しい画面を覚えるか」ではなく「動いている処理をどう止めずに載せ替えるか」という運用の問題になりました。

ここでは、稼働中の自動運用を止めないまま大型更新へ移るための段取りを、私が実際に踏んだ順序で整理します。

移行日が決まっている更新は「切り替え」ではなく「並走」で考える

締め切りがある移行で一番危ないのは、期限の前日にまとめて切り替えることです。新環境で初めて流すジョブが、たまたまその日の本番処理になってしまう。これが一番避けたい形です。

私は移行を「ある日を境に旧から新へ乗り換える」操作だとは考えていません。「新旧を一定期間並べて走らせ、出力が一致することを確認してから旧を畳む」という、重なりのある工程として設計します。

並走期間を取れるかどうかは、移行の安全性をほぼ決めてしまいます。期限が公表されたら、まず逆算して「いつから並走を始めれば、期限までに十分な回数を比較できるか」を先に決めます。

並走期間に確認するのは「出力が同じか」だけ

並走中に見るべき指標は、突き詰めると一つです。同じ入力を与えたとき、新環境が旧環境と同じ成果物を出すか。

私の場合、記事生成パイプラインの最終成果物は MDX ファイルと、それを検証する品質ゲートの合否です。なので比較も成果物どうしで行います。新旧それぞれに同じトピックを渡し、生成された MDX を機械的に差分で突き合わせます。

# 旧環境(gemini)と新環境(agy)に同じ入力を渡し、成果物を比較する
INPUT="content/_fixtures/sample_topic.json"
 
gemini run generate --input "$INPUT" --out /tmp/out_old
agy run generate --input "$INPUT" --out /tmp/out_new
 
# フロントマターと本文の構造が一致するかを差分で確認
diff <(grep -E '^(title|slug|category|level|premium):' /tmp/out_old/*.mdx) \
     <(grep -E '^(title|slug|category|level|premium):' /tmp/out_new/*.mdx) \
  && echo "✅ frontmatter parity" || echo "⚠️ frontmatter drift — 要確認"
 
# 生成本文の文字数が極端にずれていないか(±15%以内を目安)
OLD=$(wc -m < /tmp/out_old/body.txt); NEW=$(wc -m < /tmp/out_new/body.txt)
echo "old=$OLD new=$NEW ratio=$(awk "BEGIN{printf \"%.2f\", $NEW/$OLD}")"

文章そのものは生成のたびに変わるので、一字一句の一致は求めません。見るのは構造の同値です。フロントマターの必須フィールドが揃っているか、本文の分量が想定の範囲か、品質ゲートを同じように通過するか。この3点が安定して一致すれば、出力は実用上同じと判断します。

✦

ここまでお読みいただきありがとうございます。

この記事の続きを読む

この先には、実装コードやベンチマーク結果など、実務でお役に立てる内容をご用意しています。このサイトは広告を掲載しておらず、サーバーや開発にかかる費用はメンバーの皆様のご支援で成り立っています。もしお役に立てていましたら、ご支援いただけますと大変ありがたいです。

この記事で得られること
✦新旧2系統を1〜2週間並走させ、出力の同値性を確認してから切り替える手順
✦移行で環境が壊れたときに数分で戻すためのバージョン固定とロールバック経路
✦4サイトの定期運用を1サイトずつ段階導入した実際の順序と判断基準
Stripe による安全な決済 · いつでもキャンセル可能
✦

この記事を購入する

この先の内容をすべてお読みいただけます。一度のご購入で、いつでも何度でもアクセスできます。このサイトは広告を掲載しておらず、皆さまのご支援がサーバー費用などの運営を支えています。

または
メンバーシップなら全記事が読み放題 →
シェア

お読みいただきありがとうございます

Antigravity Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • ✦コピー&ペーストで使える実装コード付き
  • ✦毎日新しい上級ガイドを追加
  • ✦¥580/月 または ¥1,480 の永久アクセス
メンバーシップを見る →

関連記事

◈ Agents & Manager2026-03-28
Antigravity Agent でデータベースマイグレーションを安全に自動化する方法
Antigravity のAIエージェントでデータベースマイグレーションを安全に自動化する実践設計。AGENTS.md によるポリシー定義、変更タイプ別の危険度整理、Expand/Contract の二段階設計、Shadow DB での事前差分検証、大テーブルでのロック実測まで、個人開発の失敗から逆算してまとめました。
◉ Antigravity 基本2026-11-16
Orchestrator・/swarm・/run-workflow を作業の形で選び分ける — 並列にする前に確かめている3つの問い
11月に Antigravity へ Orchestrator・/swarm・/run-workflow が相次いで入り、どれで頼むかを毎回迷うようになりました。モデルの性能ではなく作業の形(判断が1つか、項目が独立しているか、途中で相談が要るか)から選ぶ3つの問いと、ワークフロー台本を承認前に読むときの見どころをお伝えします。
◉ Antigravity 基本2026-10-24
ファイルはあるのに「no such file」と言われる — Linux で同梱 ripgrep が動かないとき、見るのはパスではなくインタープリタ
Linux で agy の grep 検索だけが失敗し、ログに「no such file or directory」と出る。ファイルは確かに存在しているのに起きる理由を、ELF のインタープリタという視点で切り分け、再現手順と一時的な回避策までまとめました。