← 戻る

Cloud Functions の影響範囲デプロイを dependency-cruiser で実現する

cloud-functions dependency-cruiser ci monorepo

関数が200個ある Cloud Functions プロジェクトで「変更ファイルから影響を受ける関数だけデプロイ」を機械化した話。grep ベースだと共通ヘルパー経由の多段依存を追えず、結局は全デプロイに流れがち。dependency-cruiser の依存グラフ JSON を使えば transitive 依存を一発で解ける。

構成

  1. 関数エントリ辞書の抽出: index.ts を ts-morph で AST パースして { 関数名 → ファイルパス } を生成。環境分岐（if (ENV === 'production') など）も追う
  2. 依存グラフ生成: depcruise --output-type json src で全モジュールの依存JSONを出力（数百ファイルでも1〜2秒）
  3. 影響範囲計算: git diff の変更ファイル集合から逆依存グラフを BFS で辿り、エントリ集合との積集合を取る

ハマりどころ

  • 全デプロイに倒すべきファイルを別途定義する: package.json, tsconfig.json, firebase.json, エントリ辞書の構造変更（関数追加・削除）。これらは transitive 解析では検出できない
  • base ref の辞書は git show <ref>:path で一時ディレクトリに再構築して比較。worktree を切るより軽い
  • depcruise 結果はキャッシュ推奨（src の mtime で自動失効）

限界

静的解析なので process.env.FUNCTION_NAME 的な文字列参照や動的 import は追えない。その場合は --all で全デプロイにフォールバックできる逃げ道を残しておく。

# 実行例
ts-node scripts/affected-functions.ts --env production --base origin/main --json
# → { fullDeploy: false, affectedFunctions: [...], deployCommand: "firebase deploy --only functions:a,b,c" }