Gemini のモデル非推奨を CI で先回りして止める仕組み

# scan_models.py — リポジトリ内の Gemini モデルID参照を集める
import re
from pathlib import Path
 
# gemini-2.5-flash / gemini-3-pro-image-preview / models/gemini-... を拾う
MODEL_RE = re.compile(r"(?:models/)?(gemini-[a-z0-9][a-z0-9.\-]*)")
 
# 走査対象。ロックファイルや生成物は除外する
SCAN_EXT = {".py", ".ts", ".tsx", ".js", ".mjs", ".mdx", ".md", ".yaml", ".yml"}
SKIP_DIRS = {"node_modules", ".git", ".next", "dist", "build"}
 
def scan(root: str) -> dict[str, list[str]]:
    """モデルID -> 出現したファイルパスの一覧"""
    found: dict[str, list[str]] = {}
    for path in Path(root).rglob("*"):
        if not path.is_file() or path.suffix not in SCAN_EXT:
            continue
        if any(part in SKIP_DIRS for part in path.parts):
            continue
        text = path.read_text(encoding="utf-8", errors="ignore")
        for m in set(MODEL_RE.findall(text)):
            found.setdefault(m, []).append(str(path))
    return found
 
if __name__ == "__main__":
    import json, sys
    result = scan(sys.argv[1] if len(sys.argv) > 1 else ".")
    print(json.dumps(result, indent=2, ensure_ascii=False))

{
  "gemini-2.5-flash": ["scripts/ogp.py", "content/articles/ja/gemini-api/foo.mdx"],
  "gemini-3-pro-image-preview": ["scripts/wallpaper_batch.py"]
}

# live_models.py — google-genai SDK で現在提供中のモデルIDを取得
from google import genai
 
def live_model_ids(api_key: str) -> set[str]:
    client = genai.Client(api_key=api_key)
    ids = set()
    for m in client.models.list():
        # name は "models/gemini-2.5-flash" の形式で返る
        ids.add(m.name.removeprefix("models/"))
    return ids
 
if __name__ == "__main__":
    import os
    live = live_model_ids(os.environ["YOUR_API_KEY"])
    print(f"提供中モデル数: {len(live)}")

# guard.py — 期限・参照・存在を突き合わせて終了コードを決める
import sys
from datetime import date
 
# 非推奨ページを見て手で更新する。停止日(UTC)を ISO で持つ
SHUTDOWN_REGISTRY = {
    "gemini-3.1-flash-image-preview": "2026-06-25",
    "gemini-3-pro-image-preview":     "2026-06-25",
    "gemini-2.0-flash":               "2026-09-24",
}
 
# 残り日数のしきい値。運用の余裕に合わせて調整する
WARN_DAYS = 30   # これ以下で警告（黄）
FAIL_DAYS = 7    # これ以下で失敗（赤）
 
def evaluate(found: dict[str, list[str]], live: set[str], today: date):
    problems = []
    for model, files in found.items():
        deadline = SHUTDOWN_REGISTRY.get(model)
        gone = model not in live
        days = None
        if deadline:
            days = (date.fromisoformat(deadline) - today).days
        # 判定: 存在しない or 期限切れ間近を拾う
        if gone:
            problems.append(("FAIL", f"{model} は提供一覧にありません（停止済み/誤記）", files))
        elif days is not None and days <= FAIL_DAYS:
            problems.append(("FAIL", f"{model} は残り {days} 日で停止します", files))
        elif days is not None and days <= WARN_DAYS:
            problems.append(("WARN", f"{model} は残り {days} 日で停止します", files))
    return problems
 
def main(found, live):
    problems = evaluate(found, live, date.today())
    exit_code = 0
    for level, msg, files in sorted(problems, reverse=True):
        mark = "🔴" if level == "FAIL" else "🟡"
        print(f"{mark} [{level}] {msg}")
        for f in files:
            print(f"      └ {f}")
        if level == "FAIL":
            exit_code = 1
    if not problems:
        print("✅ 期限が近い・停止済みのモデル参照はありません")
    sys.exit(exit_code)

🔴 [FAIL] gemini-3-pro-image-preview は残り 5 日で停止します
      └ scripts/wallpaper_batch.py
🟡 [WARN] gemini-2.0-flash は残り 96 日で停止します
      └ scripts/ogp.py

# .github/workflows/model-deprecation-guard.yml
name: model-deprecation-guard
on:
  push:
    branches: [main]
  schedule:
    - cron: "0 0 * * *"   # 毎日 09:00 JST（UTC 00:00）
jobs:
  guard:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with: { python-version: "3.12" }
      - run: pip install google-genai
      - run: python run_guard.py .
        env:
          YOUR_API_KEY: ${{ secrets.GEMINI_API_KEY }}