GitHub Actions の runner(runs-on)は 版を固定する。ubuntu-latest / windows-latest は使わない。
| 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)の結果で代わりに確かめる。 - 上げたら、この表を更新する。