🐙
GitHub Actions でメタデータ (actions.yml) 側のスクリプトを実行する方法
TL;DR
${{ github.action_path }} を使う。
メタデータとワークフロー
GitHub Actions には、メタデータとワークフローの 2 種類が存在する。ファイル名やディレクトリ構造、使用用途についての違いは以下のとおり。
| 名称 | ファイル名・ディレクトリ構造 | 使用用途 | 備考 |
|---|---|---|---|
| メタデータ | action.yml |
外部のリポジトリで特定の処理を実行させたり、他のユーザに使ってもらったり、マーケットプレイス に公開したりしたい場合 | |
| ワークフロー | .github/workflow/***.yml |
そのリポジトリ内のみで任意の処理を実行したい場合 | ファイル名 (*** の部分) は任意 |
ワークフローはそのリポジトリで動作するものなので、任意のコマンドやスクリプトを実行させたい場合はそのままパスを指定すれば良い。
たとえば、リポジトリのルートディレクトリに main.rb というファイルがあり、それを実行したい場合は、単に ruby main.rb のように記述すれば良い。
問題点
しかし、メタデータでそのように記述してしまうと、そのメタデータを使うリポジトリ側、つまりワークフロー側のパスを参照してしまう。
たとえば、リポジトリ A (username/repo-a) には、以下のようなメタデータ (action.yml) が置かれているとする[1]。
action.yml
runs:
using: "composite"
step:
- run: ruby main.rb
shell: sh
上記のメタデータをリポジトリ B で使いたいとする[1:1]。ファイル名は適当に ruby.yml としている。
.github/workflow/ruby.yml
jobs:
ruby:
runs-on: ubuntu-latest
steps:
- uses: username/repo-a
この状態で、リポジトリ B でワークフローを実行すると、ruby main.rb が実行されるのだが、ここでいう main.rb はリポジトリ B の main.rb を参照してしまう[2]。
ワークフロー側 (リポジトリ B) ではなく、メタデータ側 (リポジトリ A) にある main.rb を実行させたい場合はどうすれば良いだろうか。
解決策
${{ github.action_path }} を使うことでメタデータ側のパスを指定することができる。メタデータを以下のように書き換える。
action.yml
runs:
using: "composite"
step:
- - run: ruby main.rb
+ - run: ruby $GITHUB_ACTION_PATH/main.rb
shell: sh
+ env:
+ GITHUB_ACTION_PATH: ${{ github.action_path }}
すると、main.rb はメタデータ (リポジトリ A) のほうを参照してくれるようになる。
参考
- changed-files/action.yml at 9125e4d5da611929abd53b039acc130bc6d19a01 · tj-actions/changed-files
- github-to-qiita/action.yml at 7cb850a7bbf9a3b23eb7896c0e1e8c5c50d798c6 · noraworld/github-to-qiita
- Workflow syntax for GitHub Actions
- Metadata syntax for GitHub Actions
Discussion