Skip to content

ci: 品質ゲートを reusable workflow に分け、入口をトリガーごとにする - #34

Merged
kryota-dev merged 2 commits into
mainfrom
refactor/31-split-workflows
Oct 14, 2026
Merged

kryota-dev merged 2 commits into
mainfrom
refactor/31-split-workflows

Conversation

@kryota-dev

Copy link
Copy Markdown
Owner

概要

ci.yml が抱えていた品質ゲート・Preview・本番デプロイを、品質ゲートの reusable workflow(quality.yml)と、トリガーごとの入口(pull-request.yml / main.yml)に分ける。イベントによる if の分岐と、式で切り替える cancel-in-progress が無くなる。

設計は #29 の方針どおり。意図と範囲は #31 の起票時に合意したので、着手前の確認は省いた。

closes #31
closes #29

変更内容

  • quality.yml(workflow_call): 元の ci ジョブをそのまま移した(ジョブ名 Lint, build, and quality gates も同じ)。concurrency は書かない(呼び出し元と同じグループにすると、呼び出し元を取り消してしまう)
  • pull-request.yml: quality → preview。PR 番号ごとのグループで cancel-in-progress: true
  • main.yml: quality → deploy。cancel-in-progress: false
  • preview と deploy は、if のイベント判定と needs 以外は元と同じ。environment は呼び出し元のジョブに付いたままなので、secret とデプロイ先の制限の効き方は変わらない
  • ci.yml を消した
  • preview-cleanup.yml・wrangler.jsonc のコメントと、AGENTS.md・docs/deployment.md を新しい構成に合わせた。docs/deployment.md には必須チェックの項を足した

必須チェックの切り替え(マージの直前)

reusable workflow のジョブのチェック名は「呼び出し元のジョブ名 / 呼ばれた側のジョブ名」になる。この PR では旧名の Lint, build, and quality gates が報告されないので、ruleset を切り替えるまでマージできない。新しい名前が報告されるのを確かめてから、マージの直前に ruleset「main protection」の必須チェックを置き換える。

確認したこと

  • pnpm lint / pnpm format:check が通る(ローカル)
  • 移したジョブが、意図した箇所(if のイベント判定と needs)以外は元と同じ(YAML を読み込んで比較)
  • 品質ゲートが Quality / Lint, build, and quality gates の名前で報告され、通る
  • Preview が作られ、URL のコメントが更新される
  • ruleset の必須チェックを切り替えた
  • マージ後: main で品質ゲート → 本番デプロイ → ヘッダー検査が通る

手動の a11y チェック(画面に影響する変更のとき)

画面に影響しないので該当しない(ワークフローと文書だけの変更)。

関連

ci.yml は品質ゲート・Preview・本番デプロイを 1 つに抱え、イベントによる
if の分岐と、式で切り替える cancel-in-progress を持っていた。

- quality.yml(workflow_call): 元の ci ジョブをそのまま移す。concurrency
  は呼び出し元に任せる
- pull-request.yml: quality → preview。PR ごとに cancel-in-progress
- main.yml: quality → deploy。cancel-in-progress しない

preview と deploy は呼び出し元に直接書くので、environment の secret と
デプロイ先の制限の効き方は変わらない。同じ run の中で artifact を渡し、
ゲートを通ったビルドだけを配信する点も変わらない。

必須チェックの名前は「Quality / Lint, build, and quality gates」になる。

Refs #31
@kryota-dev kryota-dev self-assigned this Oct 14, 2026
@kryota-dev
kryota-dev marked this pull request as ready for review October 14, 2026 06:11
@github-actions

github-actions Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

@kryota-dev kryota-dev left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Multi-Review 統合レビュー結果

総合評価

カテゴリ general(Codex, xhigh) security(subagent)
MUST 0 0
SHOULD 0 2
NITS 0 3
GOOD 5 7

specialist は立てていない(変更は YAML・Markdown・JSONC だけで、条件に当たるものが無い)。

セキュリティ

  • 総合リスクレベル: Low / 悪用できる新しい経路: 0 件
  • ジョブの中身は旧 ci.yml から機械的に移されている。違いは needs、if のイベント判定の削除、ジョブ id(ci → gates)、コメントだけ。permissions・secret の届き先・fork の除外・artifact の受け渡しは旧版と同じ
  • SHOULD の 2 件は、どちらもマージする瞬間の運用手順の話で、悪用経路ではない

[SHOULD]

  • .github/workflows/main.yml:12(security): concurrency のグループが ci-refs/heads/main から main に変わる。この PR のマージで起きる push の時点で、旧 CI の run が main で走っていると、2 つの wrangler deploy が直列化されない。古いほうが後に終わると、古い版が本番に残る。起きうるのは移行の 1 回だけ。対策: マージの前に、main で走っている CI の run が無いことを確かめる
  • docs/deployment.md:37-39(security。訂正して採用): ruleset の必須チェックを、「旧名を外す」と「新名を足す」の 2 回に分けて変え、外すほうを先にすると、必須チェックが無い時間ができる。訂正: 元の指摘は「新名を足してから旧名を外す」順を勧めていた。しかし、ruleset の更新 API で必須チェックの一覧を 1 回で置き換えれば、その時間はそもそもできない。ソースの指定(GitHub Actions の app)も引き継ぐ。新名のチェックは、この PR ですでに通っている

[NITS]

  • .github/workflows/main.yml:12(security): グループ名 main は、リポジトリ全体で共有される名前としては汎用的すぎる。production-deploy などの、用途の分かる名前がよい
  • .github/workflows/main.yml(security): deploy からブランチの if を外したが、トリガーは push: branches: [main] だけで、workflow_dispatch も無い。production environment も main からしか使えないので、今は悪用できない。将来トリガーを足すときに見直せばよい
  • docs/deployment.md:39(security・既存): 同じリポジトリのブランチから、Quality / Lint, build, and quality gates という名前で成功するだけの workflow を足せば、必須チェックを満たせる。これは旧名でも同じで、移行で増えたリスクではない。共同作業者を増やすときは、CODEOWNERS で .github/ の変更をレビュー必須にすることを検討する

[GOOD]

  • .github/workflows/quality.yml: steps は旧版と一致し、artifact の名前・対象・保持期間と、失敗時のレポートの収集も保たれている(general / security)
  • pull-request.yml:17・main.yml:18: quality の呼び出しに secrets も secrets: inherit も無いので、品質ゲート(install スクリプトが動くジョブ)には secret が届かない。permissions も contents: read のまま(security)
  • pull-request.yml:23: pull_request だけをトリガーにしたので、イベント判定を外しても意味は変わらない。fork の除外は残っている(general / security)
  • concurrency: PR は run 全体を取り消し、main は取り消さないという範囲が保たれている。Preview の作成と削除の共有グループも変わらない。quality.yml に concurrency を書かないのは、公式の注意書きどおり(general / security)
  • 文書と実装は一致し、追跡ファイルに ci.yml への参照は残っていない(general / security)
  • spec との整合: AC-001〜005・007 は実装済み。AC-006(ruleset)は、マージ直前の作業として計画どおり残っている(general / security)

事実検証で棄却した指摘

なし(ruleset の切り替え順の指摘は、訂正して採用した)。

既存指摘との重複

既存のレビューと行コメントは無い(github-actions の Preview URL のコメントだけ)。除外は 0 件。

Comment thread .github/workflows/main.yml Resolved
Comment thread docs/deployment.md Resolved
Comment thread .github/workflows/pull-request.yml Resolved
グループはリポジトリ全体で共有されるので、main ではなく
production-deploy にする。ruleset の必須チェックは、一覧を 1 回の更新で
置き換えないと、必須チェックが無い時間ができることを文書に書く。

Refs #31
@kryota-dev

Copy link
Copy Markdown
Owner Author

review body にだけある指摘への対応です。

  • deploy からブランチの if を外した件(.github/workflows/main.yml): 対応不要と判断しました。トリガーは push: branches: [main] だけで、production environment も main からしか使えません。トリガーを足すときに見直します。
  • 必須チェックの名前の偽装(docs/deployment.md:39): 対応不要と判断しました。旧名でも同じで、この移行で増えたリスクではありません。書き込み権限は作者にしか無いので、共同作業者を増やすときに CODEOWNERS などを検討します。

@kryota-dev
kryota-dev merged commit 6ab3f26 into main Oct 14, 2026
6 checks passed
@kryota-dev
kryota-dev deleted the refactor/31-split-workflows branch October 14, 2026 06:41

This branch was successfully deployed

1 active deployment
preview — ccc131ba Deployed Oct 14, 2026 by kryota-dev via Delete the Preview #16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant