Skip to content

ci(quality): setup を composite action にし、品質ゲートを並列ステップで縮める - #32

Merged
kryota-dev merged 3 commits into
mainfrom
refactor/30-ci-setup-parallel-steps
Oct 14, 2026
Merged

kryota-dev merged 3 commits into
mainfrom
refactor/30-ci-setup-parallel-steps

Conversation

@kryota-dev

@kryota-dev kryota-dev commented Oct 14, 2026 •

Copy link
Copy Markdown
Owner

概要

ワークフローに 4 回あった setup(pnpm + Node + install)を composite action にまとめ、品質ゲートのジョブを並列ステップで縮める。ワークフローの分割(#31)の前段で、必須チェック名と配信の振る舞いは変えない。

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

closes #30

変更内容

  • .github/actions/setup を足した。pnpm/action-setup・setup-node(cache: pnpm)・pnpm install --frozen-lockfile を行う。install スクリプトは既定で止め(--ignore-scripts)、install-scripts: "true" のときだけ動かす。それ以外の値なら失敗する
  • ci ジョブ(install-scripts: "true")、preview・deploy・preview-cleanup.yml(既定)の setup を、この action に置き換えた
  • ci ジョブを並べ直した
    • Playwright のブラウザと lychee を background で入れる
    • lint・format・astro check を parallel にする。build は、astro check と同じ .astro/ に書くので、このグループから外した
    • links と a11y の前で、それぞれ必要なインストールを wait する(background のステップの GITHUB_PATH は wait まで反映されない)
    • a11y と Lighthouse は直列のまま。同じマシンで CPU を奪い合うと、Lighthouse の Performance が変動するため
  • AGENTS.md と docs/deployment.md を合わせた

確認したこと

  • pnpm lint / pnpm format:check が通る(ローカル)

  • pnpm check / pnpm build / pnpm test:html / pnpm test:links / pnpm test:a11y / pnpm test:lighthouse が通る(CI。サイトのソースは変えていない)

  • 必須チェック Lint, build, and quality gates が同じ名前で報告される

  • Preview のジョブが通る

  • 品質ゲートの所要時間を比べた(下の表)。a11y を始めるまでが約 17 秒縮んだ。ジョブ全体では、Lighthouse の揺れ(今回は 81 秒)の幅の中に埋もれている

    区間 変更前(main の直近の実行) 変更後(この PR)
    a11y を始めるまで 約 63 秒 46 秒
    a11y 68 秒 69 秒
    Lighthouse 70 秒 81 秒
    ジョブ全体 172〜216 秒(直近 5 回、中央値 208 秒) 202 秒

    Playwright のインストール(30 秒)は lint・check・build の裏に隠れた。並列にした lint は 4 → 8 秒、astro check は 8 → 14 秒に延びたが、グループ全体は 14 秒に収まった

  • マージ後: main で本番デプロイとヘッダー検査が通る/PR を閉じると Preview が消える

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

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

関連

pnpm・Node・install の 3 ステップが ci.yml に 3 回、preview-cleanup.yml に
1 回あったので、.github/actions/setup にまとめる。

install スクリプトは既定で止め(--ignore-scripts)、install-scripts: "true"
のときだけ動かす。トークンを持たない ci ジョブだけが指定し、Preview・本番・
Preview の削除のジョブは既定のままにする。true / false 以外の値は失敗させる。

Refs #30
Playwright のブラウザと lychee を background で入れ、lint・format・
astro check を parallel にする。build は astro check と同じ .astro/ に
書くので、このグループから外す。links と a11y の前で、それぞれ必要な
インストールを wait する(background のステップの GITHUB_PATH は wait
まで反映されない)。

a11y と Lighthouse は直列のままにする。同じマシンで CPU を奪い合うと
Lighthouse の Performance が変動するため。

Refs #30
@kryota-dev kryota-dev self-assigned this Oct 14, 2026
@github-actions

github-actions Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

@kryota-dev
kryota-dev marked this pull request as ready for review October 14, 2026 04:29

@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 0
NITS 1 4
GOOD 4 5

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

セキュリティ

  • 総合リスクレベル: Low / この PR で新しく生じた脆弱性: 0 件
  • Cloudflare のトークンを持つ 3 つのジョブ(preview / deploy / preview-cleanup)は、変更前と同じく --ignore-scripts で依存を入れる。ローカル action は、どのジョブでも checkout の後に参照されている。pull_request_target の preview-cleanup では base 側の action.yml が読まれるので、PR 側のコードは動かない

[MUST] / [SHOULD]

なし。

[NITS]

  • docs/deployment.md:24(general): 「トークンを持たない ci ジョブ」は不正確。ci にも contents: read の GITHUB_TOKEN がある。「Cloudflare のトークンを持たない」とするのがよい
  • .github/workflows/ci.yml:27-29(security。未確認の前提あり): allowBuilds は 2 つとも false で、ルートの package.json にライフサイクルスクリプトも無い。そのため、install-scripts: "true" にしても、今は実行されるスクリプトが変わらない。ただし、--ignore-scripts を付けると strictDepBuilds の検査(許可していないビルドスクリプトを持つ依存が入ったら失敗させる)が飛ばされるのなら、ci ジョブで "true" にしておく意味がある。pnpm 10.28 でこの挙動は確かめきれていない
  • .github/workflows/ci.yml:39-53(security): 同時に走る lint / check / build が、lychee の sha256 検証と展開の間にアーカイブを差し替えることは原理上できる。ただし、それらは同じジョブで同じ権限を持ち、変更前から $GITHUB_PATH を書き換えられた。ci ジョブには secret も書き込み権限も無い。新しい権限は得られないので、悪用経路にはならない
  • (範囲外・既存).github/actions/setup/action.yml:17-20(security): main では ci(依存のコードを実行する)と deploy(本番トークンを持つ)が、同じスコープの pnpm のキャッシュを共有する。依存が侵害され、キャッシュを書き込めた場合に deploy の復元が汚染されうる(キャッシュが外れた run に限られ、pnpm のストアの整合性検証もあるので難度は高い。未確認)。この PR では悪化していない。setup を composite にまとめたので、トークンを持つジョブだけキャッシュを切る対策を 1 箇所で入れられる。別の issue で扱う候補
  • (範囲外・既存)preview environment には制限が無い。ただし、同じリポジトリに push できる人は、もともと workflow を書き換えられる。fork PR は除外されている

[GOOD]

  • .github/actions/setup/action.yml:25: 入力を env で受け、true / false 以外を失敗させている。式の展開によるインジェクションは起きない(general / security)
  • .github/actions/setup/action.yml: install スクリプトを既定で止めている。今後ジョブを足して指定を忘れても、安全な側に倒れる(security)
  • .github/workflows/ci.yml:56: build を parallel から外し、.astro/ への書き込みが astro check とぶつからないようにしている。ESLint と Prettier は .astro/ を無視している(general)
  • .github/workflows/ci.yml:73,79: lychee と Playwright を、使う直前にそれぞれ wait している。lychee の完全性検証も保たれている(general / security)
  • 失敗時のレポートのアップロードと、ゲートを通ったときだけの artifact の保存は、変更前のまま(general)
  • spec(requirements / design / tasks)との整合: タスク 1〜4 に取りこぼしや逸脱は無い。タスク 5(CI での確認)は PR 作成後の作業(general / security)

事実検証で棄却した指摘

なし。

既存指摘との重複

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

Comment thread docs/deployment.md Resolved
Comment thread .github/actions/setup/action.yml Resolved
Comment thread .github/workflows/ci.yml Resolved
Comment thread .github/workflows/ci.yml Resolved
ci ジョブにも GITHUB_TOKEN はあるので、持たないのは Cloudflare の
トークンだと書く。

Refs #30
@kryota-dev

Copy link
Copy Markdown
Owner Author

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

  • install-scripts: "true" の実効(.github/workflows/ci.yml:27-29): 対応不要と判断しました。今の値に害はありません。また、--ignore-scripts を付けると strictDepBuilds の検査(pnpm-workspace.yaml の許可リストに無いビルドスクリプトを持つ依存が入ったら失敗させる)が飛ばされるかどうかは、確かめきれていません。飛ばされるのであれば、ci ジョブで "true" にしておくことで、その検査を残せます。
  • lychee の検証と展開の間の差し替え(.github/workflows/ci.yml:39-53): 対応不要と判断しました。同時に走るステップは同じジョブで同じ権限を持ち、変更前から $GITHUB_PATH を書き換えられました。ci ジョブには secret も書き込み権限も無いので、権限の境界を越えません。
  • pnpm のキャッシュの共有、preview environment の制限: この PR より前からある性質で、この PR の範囲外です。キャッシュについては、別の issue で扱うかを判断します。

This branch was successfully deployed

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ci(quality): setup を composite action にし、品質ゲートを並列ステップで縮める

1 participant