2026-04 Sentry Release Deploy Tracking 要件

背景

現行の Sentry 運用では、release 名・commit association・finalize・sourcemap upload までは自動化されているが、release がどの環境へ実際に配備されたか を Sentry 上で辿る deploy marker が不足している。

この不足により、次の観点が弱くなる。

• staging / production で同じ release がいつ出たかを release 画面から追えない
• issue regression と deploy の前後関係を Sentry 単体で説明しにくい
• release health を環境差分込みで読む際に GitHub Actions と突き合わせが必要になる

要件

1. release finalize 後に deploy marker を作成する。
2. deploy marker は少なくとも以下を持つ。
3. release
4. project
5. environment
6. url
7. name
8. deploy marker の作成導線は workflow ごとに bash を重複させず、 共通 GitHub Action に集約する。
9. 対象 surface は以下の 3 つとする。
10. Storefront Workers
11. React Dashboard Workers
12. Vendure Fly
13. environment は repo 既定の dev / staging / prod へ寄せず、Sentry 側では 実際の workflow 入力で解決された environment 名 をそのまま使用する。 ただし現状の deploy workflow では staging / production を前提とする。

非要件

• deploy marker を source of truth にして GitHub Actions の deploy 成否判定を置き換えない
• 既存の release 名規約（<surface>@<sha>）は今回変更しない
• 今回は deploy duration の厳密計測を必須としない

受け入れ条件

1. Storefront / React Dashboard / Vendure の各 deploy workflow が、成功時に finalize の後で deploy marker を 1 件作成する。
2. deploy marker の environment は workflow の deploy target と一致する。
3. Sentry release helper は prepare / finalize に加えて deploy コマンドを持つ。
4. release helper のテストが deploy endpoint 生成を検証する。