Act
概要
ActはDockerを使用してGitHub Actionsワークフローをローカルで実行します。GitHubにプッシュすることなくCIパイプラインをテスト・デバッグできます。ほとんどのGitHub Actions機能をサポートしています。
手順
ステップ1:インストール
brew install act
ステップ2:ワークフローの実行
act # pushイベントを実行
act pull_request # PRイベントを実行
act -j test # 特定のジョブを実行
act -W .github/workflows/ci.yml # 特定のワークフロー
act --secret-file .env.secrets # シークレットを指定
ステップ3:設定
# .actrc — デフォルト設定
-P ubuntu-latest=catthehacker/ubuntu:act-latest
--env-file .env
ステップ4:デバッグ
act -n # ドライラン
act -v # 詳細出力
act -l # ワークフロー一覧表示
ガイドライン
- 初回実行時にDockerイメージ(約1〜3GB)がダウンロードされます。
- すべてのGitHub Actions機能がローカルで動作するわけではありません(例:OIDCトークン)。
- より高速な実行のために軽量イメージを使用してください。
- GitHubランナーを待たずにCIを反復開発するのに最適です。