■ はじめに

今回は、Github Actions の ワークフロー実行
の行う・行わないを制御するために必要な扱う。

【１】needs

* Job依存を指定できる
 => 指定した Job の後に実行される

https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idneeds

例

jobs:
  job1:
    runs-on: ubuntu-latest
    steps:
      - run: ./job1.sh
  job2:
    needs: job1
    # job2 needs job1
    # => この job2 は、 job1 が必要です
    # => job2実行は、job1 実行後に行われる
    runs-on: ubuntu-latest
    steps:
      - run: ./job2.sh

１）needs.<job_id>.result

* 依存Jobの処理結果を保持
* 取りうる値は、success, failure, cancelled, skipped.

https://docs.github.com/en/actions/learn-github-actions/contexts#needs-context

job-main:
  name: Sample Job
  runs-on: ubuntu-latest
  needs: [sub-job1, sub-job2, sub-job3]
  if: |
    always() &&
    needs.sub-job1.result == 'success' && # ★注目★
    (needs.sub-job2.result == 'success' || needs.sub-job2.result == 'skipped') &&
    (needs.sub-job3c.result == 'success' || needs.sub-job3.result == 'skipped')

２）needs.<job_id>.outputs.

* 依存Jobのoutputsの各Outputを保持

【２】if

* if [条件] で、[条件] が真になった場合に実行する

https://docs.github.com/ja/actions/learn-github-actions/expressions#status-check-functions

* 詳細は、以下の関連記事を参照のこと

Github Actions ～ if ～
https://dk521123.hatenablog.com/entry/2024/03/11/000000

【３】on

* Githubイベント(push/pull_request etc)をハンドリングしてくれる
* 大きく分けて、以下の4種類。
 [1] Githubイベント
 [2] 時刻指定
 [3] 手動実行
 [4] ワークフロー依存

主なGithubイベント
https://docs.github.com/ja/actions/using-workflows/events-that-trigger-workflows

イベント	説明	memo
push	リモートリポジトリへpush時	特定のbranch/path/tagなどを指定することも可能
pull_request	プルリクエスト作成時
deployment	デプロイ時
release	リリース時
workflow_run	ワークフローの実行時	前ワークフローの完了後に次のワークフローが開始
workflow_call	ワークフロー呼び出し時
workflow_dispatch	ワークフロー手動実行
schedule	cronによる定期実行

１）push

主なプロパティ

* path : 対象パスのみ実行
* paths-ignore : 対象パスは除外（無視）

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

例：path / paths-ignore

on:
  push:
    paths:
      # JavaScript ファイル (.js) をプッシュするたびに実行
      - '**.js'
    paths-ignore:
      # 以下は除外
      - 'docs/**'
      - '.github/workflows/**'

２）workflow_run / workflow_call

* 詳細は、以下の関連記事を参照のこと

Github Actions ～ workflow_run / workflow_call ～
https://dk521123.hatenablog.com/entry/2024/02/14/232546

例

on:
  workflow_run:
    workflows: [Build] # Build という名前のワークフローが実行
    types: [completed] # completed (完了したら)
    branches: [canary] # 名前が canary のブランチ

３）workflow_dispatch

* ワークフロー手動実行
 => 詳細は、以下の関連記事を参照のこと

Github Actions ～ workflow_dispatch / 手動実行～
https://dk521123.hatenablog.com/entry/2024/03/12/012953

４）schedule

* 時刻指定
* cronによる定期実行

５）pull_request

* プルリクエスト時に発行
 => 詳細は、以下の関連記事を参照のこと

Github Actions ～ pull_request / pull_request_target ～
https://dk521123.hatenablog.com/entry/2024/04/10/152101

プログラムの超個人的なメモ

Memo for Programming.

【Github】Github Actions ～ワークフロー制御～

■ はじめに

目次

【１】needs

１）needs.<job_id>.result

２）needs.<job_id>.outputs.

【２】if

【３】on

１）push

２）workflow_run / workflow_call

３）workflow_dispatch

４）schedule

５）pull_request

関連記事