GitHub ActionsをTypeScriptで作ろう！

■ イベント
TSKaigi
https://2025.tskaigi.org/

■ 発表者
技術本部 Bill One Engineering Unit Core Business UMグループ
上司 陽平

■ Bill One エンジニア 採用情報
https://media.sansan-engineering.com/billone-engineer

Transcript

1. GitHub Actionsを TypeScriptで作ろう！ Sansan株式会社 上司陽平（じょーし）
2. 2 © Sansan, Inc. ⾃⼰紹介 じょーし Sansan株式会社 @paper2parasol - インボイス管理サービス「Bill One」のソフトウェ アエンジニア兼SRE - 負荷試験による性能改善、IaC化と⽂化醸成、機能 開発などを担当 - 有志メンバによるCI/CD改善チームを運営し、⽇々 の開発者体験の向上に取り組む - GitHub Actionsの実⾏時間を可視化するOSS 「GitHub Actions OpenTelemetry」を個⼈開発 - 好きなものはラーメンとCloud Run
3. GitHub Actionsを作って わかった知⾒をまとめました
4. 4 © Sansan, Inc.
5. GitHub Actionsの開発ツールは TypeScriptに偏っている
6. GitHub Actions公式リポジトリ
7. 60%（45/75）
8. カスタムアクションは TypeScriptと相性が良い
9. そんな理由を紹介していきます
10. カテゴリ TypeScript 他⾔語（Go, Java, Ruby…etc） 公式サポート GitHubが提供するGitHub Actions Toolkitをフルに利⽤できる 唯⼀の⾔語。⼊⼒・出⼒・ログ・エラー・シークレット・フ ァイルI/Oなど“全部⼊り”のAPIが揃う。 Toolkitが無いので、環境変数や GITHUB_OUTPUTファイルなどを⾃分で 扱う必要がある。GitHub Actionsの仕様を 理解して、ツールを⾃作する必要がある。 実⾏速度 パッケージ済みJSをrunnerが直接実⾏する。CIで並列マトリ クスを回しても“ほぼ即起動”。 基本Dockerコンテナを利⽤する。イメー ジ取得などに時間がかかり、コールドス タートが遅い。 プラットフォーム 追加設定なしでLinux / Windows / macOSすべて動作。 Dockerなら基本Linuxのみ。 GitHub API連携 TypeScriptの型推論・エディタ補完、VitestなどJSエコシス テムのテスト・Lintツールをそのまま利⽤可能。 HTTPリクエストを⼿書きするか、各⾔語 ⽤Octokitを利⽤する。公式SDKがない⾔ 語も多い。 開発体験 TypeScriptの型推論・エディタ補完、Jest/VitestなどJSエコ システムのテスト・Lintツールをそのまま利⽤。公式テンプ レートactions/typescript-actionで即開始可能。 テンプレートや⽀援ライブラリがほぼ無 い。セットアップやテスト戦略を⾃分で 組み⽴てる必要がある。
11. 11 © Sansan, Inc. 公式サポート TypeScript 他⾔語（Go, Java, Ruby…etc） − GitHub Actions Toolkitをフルに 利⽤できる唯⼀の⾔語。 − ⼊⼒・出⼒・ログ・エラー・シ ークレット・ファイルI/Oなど “全部⼊り”のAPIが揃う。 − Toolkitが無いので、環境変数や GITHUB_OUTPUTファイルな どを⾃分で扱う必要がある。 − GitHub Actionsの仕様を理解し て、ツールを⾃作する必要があ る。
12. 12 © Sansan, Inc. 実⾏速度 TypeScript 他⾔語（Go, Java, Ruby…etc） − パッケージ済みJSをrunnerが直 接実⾏する。 − CIで並列マトリクスを回しても “ほぼ即起動”。 − 基本Dockerコンテナを利用する。 − イメージ取得などに時間がかか り、コールドスタートが遅い。
13. 13 © Sansan, Inc. プラットフォーム TypeScript 他⾔語（Go, Java, Ruby…etc） − 追加設定なしでLinux / Windows / macOSすべて動作。 − Dockerなら基本Linuxのみ。
14. 14 © Sansan, Inc. GitHub API連携 TypeScript 他⾔語（Go, Java, Ruby…etc） − GitHubが提供するOctokitを利 ⽤可能。 − 型定義付きで安全。 − OctokitはGitHub Actions Toolkit にも含まれている。 − HTTPリクエストを⼿書きする か、各⾔語⽤Octokitを利⽤する。 − 公式SDKがない⾔語も多い。
15. 15 © Sansan, Inc. 開発体験 TypeScript 他⾔語（Go, Java, Ruby…etc） − TypeScriptの型推論・エディタ 補完、VitestなどJSエコシステ ムのテスト・Lintツールをその まま利⽤可能。 − 公式テンプレート actions/typescript-actionで即開 始可能。 − テンプレートや⽀援ライブラリ がほぼ無い。 − セットアップやテスト戦略を⾃ 分で組み⽴てる必要がある。
16. 16 © Sansan, Inc. actions/typescript-action
17. 17 © Sansan, Inc. actions/typescript-actionについてはこのブログでもまとめています！！ https://paper2.hatenablog.com/entry/2024/09/22/165319
18. ご清聴ありがとうございました
19. 19 © Sansan, Inc. © Sansan, Inc. 請求書受領から、月次決算を加速する インボイス管理サービス