TL;DR

${{ github.action_path }} を使う。

メタデータとワークフロー

GitHub Actions には、メタデータとワークフローの 2 種類が存在する。ファイル名やディレクトリ構造、使用用途についての違いは以下のとおり。

ワークフローはそのリポジトリで動作するものなので、任意のコマンドやスクリプトを実行させたい場合はそのままパスを指定すれば良い。

たとえば、リポジトリのルートディレクトリに main.rb というファイルがあり、それを実行したい場合は、単に ruby main.rb のように記述すれば良い。

問題点

しかし、メタデータでそのように記述してしまうと、そのメタデータを使うリポジトリ側、つまりワークフロー側のパスを参照してしまう。

たとえば、リポジトリ A (username/repo-a) には、以下のようなメタデータ (action.yml) が置かれているとする¹。

runs:
  using: "composite"
  step:
    - run: ruby main.rb
      shell: sh

上記のメタデータをリポジトリ B で使いたいとする¹。ファイル名は適当に ruby.yml としている。

jobs:
  ruby:
    runs-on: ubuntu-latest
    steps:
      - uses: username/repo-a

この状態で、リポジトリ B でワークフローを実行すると、ruby main.rb が実行されるのだが、ここでいう main.rb はリポジトリ B の main.rb を参照してしまう²。

ワークフロー側 (リポジトリ B) ではなく、メタデータ側 (リポジトリ A) にある main.rb を実行させたい場合はどうすれば良いだろうか。

解決策

${{ github.action_path }} を使うことでメタデータ側のパスを指定することができる。メタデータを以下のように書き換える。

 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