GitHub Actions 再利用可能ワークフローでネスト呼び出しと Matrix strategy が解禁

| 4 min read
Author: masahiro-kondo masahiro-kondoの画像

以前の「GitHub Actions - 再利用可能ワークフローを使う」の記事時点では、以下のような制約がありました。

  1. 再利用可能ワークフローは他の再利用可能ワークフローを呼び出すことはできない
  2. プライベートリポジトリ内の再利用可能ワークフローは、同一リポジトリ内のワークフローでのみ使用可能
  3. 呼び出し元ワークフローで定義されたワークフローレベルの環境変数は呼び出されたワークフローに伝播されない
  4. strategy プロパティは、再利用可能ワークフローを呼び出すジョブではサポートされない

このたびのリリースで、1と4の制約が解消され、再利用可能ワークフローのネスト呼び出しが可能となるとともに、呼び出し元からの Matrix strategy も使えるようになりました[1]

GitHub Actions: Improvements to reusable workflows | GitHub Changelog

早速試してみましょう。まずはネスト呼び出しから。

呼び出し側のワークフロー。再利用可能ワークフローをパラメータ付きで呼び出します。

name: Use reusable flow

on:
workflow_dispatch:

jobs:
UseReusableFlow:
uses: kondoumh/iac-dev/.github/workflows/reusable-flow.yml@master
with:
param1: hoge

再利用可能ワークフロー第1階層。パラメータを受けて、さらに、再利用可能ワークフローにパラメータを渡して呼び出ます。

name: Reusable workflow A

on:
workflow_call:
inputs:
param1:
description: 'Param1'
required: true
type: string

jobs:
call-another-reusable:
uses: kondoumh/iac-dev/.github/workflows/reusable-nested-flow.yml@master
with:
param1: ${{ inputs.param1 }}

再利用可能ワークフロー第2階層。ここで本命のジョブが動きます。渡ってきたパラメータを出力します。

name: Reusable workflow B

on:
workflow_call:
inputs:
param1:
description: 'Param1'
required: true
type: string

jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Echo
run: echo "called from reusable flow with param ${{ inputs.param1 }}!"

実行してみると、ちゃんと最下層のジョブが実行され、パラメータの受け渡しもできました。

ネストワークフロー実行

Information

再利用可能ワークフローのネスト呼び出しは、ネストは4階層まで可能なようです。

You can connect up to four levels of workflows.

また、同一オーガニゼーションやエンタープライズでは、inherit キーワードにより、暗黙的なシークレットの受け渡しも可能です。詳しくはドキュメントを参照してください。

https://docs.github.com/en/actions/using-workflows/reusing-workflows#nesting-reusable-workflows

次に、Matrix strategy です。

呼び出し側のワークフロー。strategy/matrixtargetdevstageprod のようにデプロイ先の環境を matrix で指定しています。再利用可能ワークフローの target パラメータにこの matrix を指定することにより、target の要素分のジョブが起動されてパラレルに実行されます。

name: Dploy with matrix strategy

on:
workflow_dispatch:

jobs:
ReuseableMatrixJobForDeployment:
strategy:
matrix:
target: [dev, stage, prod]
uses: kondoumh/iac-dev/.github/workflows/deployment-reusable.yml@master
with:
target: ${{ matrix.target }}

再利用可能ワークフローの deployment-reusable.yml です。inputs.target でデプロイ先の環境を受け取り、ビルド、パッケージ、デプロイを行います(この例は単に echo しているだけ)。

name: Build & Deploy for given tareget

on:
workflow_call:
inputs:
target:
description: 'Target to deploy app'
required: true
type: string

env:
TARGET: ${{ inputs.target }}

jobs:

build:
runs-on: ubuntu-latest
steps:
- name: Build
run: echo "Build for $TARGET environment"
- name: Package
run: echo "Package for $TARGET environment"
- name: Deploy
run: echo "Deploy to $TARGET environment"
Information

もしワークフローでコンテナアプリケーションの CI/CD を行う場合、ビルドは1度だけでデプロイ先の差異は環境変数で対応するのが王道ですが、ここはあくまでサンプルということでご了承ください。

実行すると、matrix が展開され各環境のジョブが実行されました。以下のスクリーンショットは、プロダクションビルドの実行結果を開いたところです。

再利用可能ワークフロー matrix 実行結果

Information

ちなみに matrix とネスト呼び出しを混在させることはできますが、ジョブに依存関係を定義したりすると意図した動きをしませんでした。あまり凝ったことはできない模様です。

以上、再利用可能ワークフローの改善ポイントを見てきました。ワークフローコードの重複削減には有効なので、機会があったら使ってみたいと思います。


  1. 2の制約も2022年12月に解消されました。詳細は「GitHub Actions - private リポジトリの Action と再利用可能ワークフローが呼び出しが可能に」を参照してください。 ↩︎

豆蔵デベロッパーサイト - 先週のアクセスランキング
  1. 基本から理解するJWTとJWT認証の仕組み (2022-12-08)
  2. AWS認定資格を12個すべて取得したので勉強したことなどをまとめます (2022-12-12)
  3. Nuxt3入門(第4回) - Nuxtのルーティングを理解する (2022-10-09)
  4. Viteベースの高速テスティングフレームワークVitestを使ってみる (2022-12-28)
  5. Nuxt3入門(第8回) - Nuxt3のuseStateでコンポーネント間で状態を共有する (2022-10-28)
  6. ORマッパーのTypeORMをTypeScriptで使う (2022-07-27)
  7. Nuxt3入門(第1回) - Nuxtがサポートするレンダリングモードを理解する (2022-09-25)
  8. Jest再入門 - 関数・モジュールモック編 (2022-07-03)
  9. GitHub Actions - 構成変数(環境変数)が外部設定できるようになったので用途を整理する (2023-01-16)
  10. Nuxt3入門(第7回) - Nuxt3のプラグイン・ミドルウェアを使う (2022-10-23)