actions/setup-go 完全に理解した

The Go gopher was designed by Renée French.

https://gotalk.connpass.com/event/398013/

Transcript

1. actions/setup-go 完全に理解した おーたかこーたろー / @otakakot 2026.07.29 Go Connect #15 The Go gopher was designed by Renée French.
2. #goconnect GitHub Actions のお話
3. #goconnect actins/setup-go を使っているのに こんな経験したことないですか？
4. #goconnect cache: true が設定されているのになぜ go get のログこんなに出てるんだ？
5. #goconnect actions/setup-go のキャッシュとは？
6. #goconnect actions/setup-go 完全に理解しよう！
7. #goconnect actions/setup-go
8. #goconnect
9. #goconnect GitHub Actions で Go を扱うとき とりあえず記述する（はず）
10. #goconnect 何がどうキャッシュされるか
11. #goconnect モジュール？ビルド？
12. #goconnect actions/setup-go の検証
13. #goconnect ex) gin でサーバー構築
14. #goconnect go version go1.26.5 darwin/arm64
15. #goconnect uses: actions/setup-go@v7.0.0
16. #goconnect
17. #goconnect 19 モジュールに依存
18. #goconnect
19. #goconnect
20. #goconnect 注：登壇資料のために省略しているので pinact とか zizmor とか使ってね
21. #goconnect /usr/bin/time コマンドで計測
22. #goconnect cache: false の検証
23. #goconnect
24. #goconnect main.go を修正して PR 作成
25. #goconnect
26. #goconnect go mod download 約 1.5 [s] go build ./... 約 30 [s]
27. #goconnect 修正して２回目を実行
28. #goconnect go mod download 約 1.5 [s] go build ./... 約 30 [s]
29. #goconnect cache: true の検証
30. #goconnect
31. #goconnect main.go を修正して PR 作成
32. #goconnect
33. #goconnect go mod download 約 1.5 [s] go build ./... 約 30 [s]
34. #goconnect 修正して２回目を実行
35. #goconnect go mod download 0.03 [s] go build ./... 約 5 [s]
36. #goconnect モジュールとビルドに キャッシュが効いた！
37. #goconnect setup-go はどうやって キャッシュするのか
38. #goconnect actions/setup-go のキャッシュ
39. #goconnect Caching dependency files and build outputs The action includes built-in caching and restoration for Go modules and build outputs. It uses toolkit/cache under the hood, but requires less configuration. https://github.com/actions/setup-goより抜粋
40. #goconnect Caching dependency files and build outputs このアクションには、Goモジュールとビル ド成果物のキャッシュおよび復元機能が組 み込まれています。内部的には toolkit/ cache を利用していますが、必要な設定は より少なくて済みます。
41. #goconnect https://github.com/actions/setup-go/blob/v7.0.0/action.yml
42. #goconnect https://github.com/actions/setup-go/blob/v7.0.0/src/package-managers.ts
43. #goconnect https://github.com/actions/setup-go/blob/v7.0.0/src/cache-utils.ts
44. #goconnect https://github.com/actions/setup-go/blob/v7.0.0/src/cache-utils.ts
45. #goconnect キャッシュキーはどうなっているか
46. #goconnect https://github.com/actions/setup-go/blob/v7.0.0/src/cache-restore.ts
47. #goconnect hash は go.mod を元に計算
48. #goconnect ちなみに v5 までは go.sum を元に計算
49. #goconnect v6 から go.mod に変更
50. #goconnect https://github.com/actions/setupgo/issues/478 & https://github.com/actions/setupgo/pull/705
51. #goconnect 2024年05月09日に起票 2026年01月26日にマージ
52. #goconnect 2026年01月05日に Filippo 氏が 「go.sum Is Not a Lockfile」 というブログを公開している
53. #goconnect 閑話休題
54. #goconnect キャッシュ保存後に go.mod を修正
55. #goconnect
56. #goconnect go mod download 約 1.5 [s] go build ./... 約 30 [s]
57. #goconnect キャッシュヒットしないことを確認
58. #goconnect actions/setup-go まとめ
59. #goconnect PR 作成時の初回実行は
 キャッシュヒットしない モジュールおよびビルドで
 キャッシュされる go.mod が変わると
 キャッシュヒットしない
60. #goconnect もうちょっといい感じにならない？
61. #goconnect 内部的に依存している toolkit/cache を 見るとなにか分かるかも？
62. #goconnect GitHub Actions のキャッシュ
63. #goconnect toolkit/cache にてキャッシュの仕組みは “Dependency caching reference” を参照
64. #goconnect キャッシュについて重要な仕様
65. #goconnect キャッシュにはアクセス制限がある キャッシュキーはフォールバックする
66. #goconnect キャッシュアクセス制限
67. #goconnect Restrictions for accessing a cache Workflow runs can restore caches created in either the current branch or the default branch (usually main). https://docs.github.com/en/actions/reference/workflows-and-actions/dependencycaching#restrictions-for-accessing-a-cacheより抜粋
68. #goconnect Restrictions for accessing a cache ワークフローの実行では、現在のブランチ またはデフォルトブランチ（通常は main） で作成されたキャッシュを復元できます。
69. #goconnect つまり、main ブランチでも setup-go を実行しておけばOK...???
70. #goconnect
71. #goconnect
72. #goconnect go mod download 約 1.5 [s] go build ./... 約 30 [s]
73. #goconnect
74. #goconnect go mod download 0.04 [s] go build ./... 約 6 [s]
75. #goconnect PR 作成時初回 CI 実行でも キャッシュヒットすることを確認
76. #goconnect キャッシュキーのフォールバック
77. #goconnect 指定したキーで完全一致検索 指定したキーで部分一致検索 restore-keys で部分一致検索
78. #goconnect actions/setup-go では未対応
79. #goconnect actions/setup-go では未対応
80. #goconnect https://github.com/actions/setup-go/ issues/358
81. #goconnect actions/cache を使って 実装する必要がある
82. #goconnect actions/cache の検証
83. #goconnect main ブランチでの CI
84. #goconnect
85. #goconnect
86. #goconnect PR での CI
87. #goconnect
88. #goconnect main.go を修正して PR 作成
89. #goconnect
90. #goconnect go mod download 0.03 [s] go build ./... 約 4 [s]
91. #goconnect go.mod を修正して PR 作成
92. #goconnect
93. #goconnect go mod download 0.6 [s] go build ./... 約 5 [s]
94. #goconnect PR 作成時初回 CI 実行でも go.mod に差分を作っても キャッシュヒットすることを確認！
95. #goconnect これで完璧なキャッシュ利用が 可能になった...???
96. #goconnect キャッシュの注意点
97. #goconnect キャッシュの保存期間は最大７日 Go のバージョンが変わるとビルド キャッシュは利用不可
98. #goconnect 今回検証したのはあくまで gin に依存した 小さなサーバー実装なので参考までに...
99. #goconnect まとめ
100. #goconnect GitHub Actions のキャッシュスコープを 意識してデフォルトブランチでも実行しよう！
101. #goconnect ビルド/モジュールキャッシュを利用する ためにフォールバックも意識しよう！
102. #goconnect Kotaro Otaka おーたかこーたろー / @otakakot 2020.04 Web Engineer 新卒入社 2021.04 Hello Golang! 2022.11 Web Engineer ＠株式会社ビットキー Gopher６年生
103. おわり またどこかで お会いしましょう！