GitHub Actions tips

別のブランチをcheckout

refでブランチ名を指定する。

- uses: actions/checkout@v3
  with:
    ref: 'develop'

• https://github.com/actions/checkout#checkout-a-different-branch

workflowを手動実行可能にする

workflow_dispatchイベントを指定すればOK。 inputsで手動実行時に渡すパラメータも指定できる。

on:
  workflow_dispatch:

• https://docs.github.com/ja/actions/using-workflows/events-that-trigger-workflows#workflow_dispatch

特定のファイルがpushされたときのみ実行

pathsでファイルパターンのリストを指定する。

on:
  push:
    branches: [ "main" ]
    paths:
    - 'src/**'

• https://docs.github.com/ja/actions/using-workflows/events-that-trigger-workflows#running-your-workflow-only-when-a-push-affects-specific-files

job, workflowの排他制御

リポジトリ内で同じ並行処理グループは同時実行数が1つに制限される。

concurrency: ci-${{ github.ref }}

• https://docs.github.com/ja/actions/using-workflows/workflow-syntax-for-github-actions#concurrency

環境変数の指定

workflow全体、job全体、step単位のそれぞれで指定可能。 式の中で環境変数を参照するには${{ env.HOGE }}のように記述する。

env:
  HOGE: fuga

• https://docs.github.com/ja/actions/using-workflows/workflow-syntax-for-github-actions#env
• https://docs.github.com/ja/actions/learn-github-actions/contexts