はじめに
GitHub Actions を利用した CI/CD パイプラインの設定では、効率的なジョブトリガーの設計が重要です。
特に、main ブランチへのすべてのプッシュでワークフローをトリガーする設定では、不要なジョブが実行され、リソースの浪費や実行時間の増加につながることがあります。
本記事では、特定のファイルやディレクトリに変更があった場合のみワークフローをトリガーする方法を中心に、無駄を省き、効率的な運用を実現するための設定方法について解説します。
少し困っていたこと
以下の設定では、main ブランチに対するすべての変更（ファイルの種類や内容に関係なく）でワークフローがトリガーされます。
on:
push:
branches:
- main
そのため、不要なトリガーが発生し、この先、ちょっとした変更を加えただけで、全てが実行されて少しだけストレスでした
問題点：全ての変更でトリガーされる
この設定では、main ブランチに対するすべての変更（ファイルの種類や内容に関係なく）でワークフローがトリガーされます。その結果、以下の問題が発生する可能性があります：
問題点
-
非効率なリソース消費
- 不必要なジョブ実行により、GitHub Actions の実行時間や料金が浪費されます。
-
無関係な変更でも実行される
- 例えば、ドキュメントやREADMEファイルの変更でもジョブが実行され、効率が低下します。
-
ジョブの実行が遅くなる
- 不要な実行が増え、並列実行数の制限に達することで、重要なジョブの実行が遅れる可能性があります。
-
ビルド・デプロイの無駄
- アプリケーションに関係のない変更（例: ドキュメント更新など）でもDockerイメージのビルドやECRへのプッシュが行われ、無駄なリソース利用が発生します。
変更前の.github/workflows/main.ymlのファイルについて
name: Push to ECR
on:
push:
branches:
- main
jobs:
build-and-push:
runs-on: ubuntu-latest
steps:
# リポジトリのクローン
- name: Checkout code
uses: actions/checkout@v3
・・・（省略）
-
設定内容
mainブランチへのすべてのプッシュイベントでワークフローがトリガーされる設定。 -
動作
ファイルの種類や内容に関係なく、すべての変更でジョブが実行される。
変更後の.github/workflows/main.ymlのファイルについて
name: Push to ECR
on:
push:
branches:
- main
paths:
- '**/*.go' # Goファイルに変更があった場合のみ実行
jobs:
build-and-push:
runs-on: ubuntu-latest
steps:
# リポジトリのクローン
- name: Checkout code
uses: actions/checkout@v3
・・・（省略）
-
pathsオプションの追加
特定のファイルパターン（**/*.go）が指定されました。 -
動作の変更
mainブランチへのプッシュ時に Goファイル（.go） に変更がある場合のみワークフローがトリガーされるようになりました。
変更後の設定について
上記のように変更する前は、テスト用のHTMLファイルを作成すると、すべての場合でGitHub Actionsがトリガーされていました。
しかし、今回の設定変更によって、main.go ファイルの変更時のみGitHub Actionsがトリガーされるようになり、正しく設定が反映されていることを確認できました。
まとめ
ここまでお読みいただき、ありがとうございました！今回の実装は簡単でしたが、このような細かい配慮が非常に重要であると改めて実感しました。
インフラのコード化に向けた第一歩として、非常に重要なポイントです。この内容をまとめることで、より深い理解を得ることができました。
この記事が、誰かの技術的な支えになれば嬉しいです！