Skip to content

Latest commit

 

History

History
38 lines (28 loc) · 2.32 KB

ci-runners.md

File metadata and controls

38 lines (28 loc) · 2.32 KB

CI runner の版固定

GitHub Actions の runner(runs-on)は 版を固定する。ubuntu-latest / windows-latest は使わない。

固定する label

OS label
Linux ubuntu-26.04
Windows windows-2025

例外(古い版に残しているジョブ)

いまは無い(全ジョブが上の表の label で動く)。古い版に残すジョブができたら、ここに 「ジョブ / 版 / 理由 / 追跡 Issue」の表を作って載せる。

なぜ固定するか

*-latest は GitHub がイメージを次の版に切り替えた日に、こちらが何も変えていなくても指す先が変わる。 入っているツール(AWS CLI・Playwright が対応する OS・apt パッケージ・Ruby をビルドする toolchain など)が 変わり、関係のない PR の CI が突然落ちる。固定しておけば、版を上げるのは「確かめてから上げる」作業に なり、落ちたときの原因も切り分けやすい。

*-latest と固定した版が混ざると、どのジョブがどの版で動くことを確かめたのかが分からなくなる。 全ジョブを同じ版にそろえ、そこから外すジョブは理由と追跡 Issue を付けて上の例外の表に載せる。

規約

  • 新しいジョブを足すときも、上の表の label を使う。ubuntu-latest / windows-latest を書かない。
  • 一部のジョブだけ古い版に残すときは、runs-on の行に 理由のコメントを書き、追跡の Issue を作る (例: runs-on: ubuntu-24.04 # <理由> (#<issue>))。理由が無いまま古い版を残さない。
  • 版を上げるときは、まず全ジョブを新しい版にした PR で CI を走らせて確かめる。PR で走らない workflow(paths で絞っているもの・workflow_dispatch だけのもの)は、そのブランチで workflow_dispatch を起動して確かめる。リリース・デプロイ・定期実行の workflow (release-gem.yml / deploy-infra-stg.yml / preview-cleanup.yml / security-monitor.yml)は PR では走らないので、同じ setup を使うジョブ(gem ビルド = gem-build-check.yml、AWS CLI = ci-cd.yml の preview-deploy)の結果で代わりに確かめる。
  • 上げたら、この表を更新する。