GitHub Actions の支払いを管理する GitHubは、macOSランナーのホストにMacStadiumを使用しています。
環境変数について
GitHubは、ワークフローの実行におけるどのステップでも使用できる、デフォルトの環境変数を設定します。 環境変数では、大文字小文字は区別されます。 アクションあるいはステップ内のコマンド実行は、環境変数を作成、読み取り、変更することができます。
カスタムの環境変数を設定するには、ワークフローファイル中でその変数を指定しなければなりません。 ステップ、ジョブ、あるいはワークフロー全体に対する環境変数は、jobs.<job_id>.steps.env、jobs.<job_id>.env、 envというキーワードを使って定義できます。 詳しい情報については、「GitHubのワークフロー構文」を参照してください。
steps:
- name: Hello world
run: echo Hello world $FIRST_NAME $middle_name $Last_Name!
env:
FIRST_NAME: Mona
middle_name: The
Last_Name: Octocat
set-env ワークフローコマンド を使用して、ワークフローの次の手順で使用できる環境変数を設定することもできます。 set-env コマンド は、アクションによって直接使用することも、run キーワードを使用してワークフローファイルのシェルコマンドとして使用することもできます。 詳しい情報については「GitHub Actionsのワークフローコマンド」を参照してください。
デフォルトの環境変数
アクションでは、ファイルシステムにアクセスするとき、ハードコードされたファイルパスを使うのではなく環境変数を使用することを強くお勧めします。 GitHubは、すべてのランナー環境でアクションが使用する環境変数を設定します。
| 環境変数 | 説明 |
|---|---|
CI | 常にtrueに設定されます。 |
HOME | ユーザーデータの格納に使用されるGitHubホームディレクトリのパス。 たとえば、/github/homeです。 |
GITHUB_WORKFLOW | ワークフローの名前。 |
GITHUB_RUN_ID | リポジトリ内でユニークな各実行に対する番号。 この番号は、ワークフローの実行をやり直しても変化しません、 |
GITHUB_RUN_NUMBER | リポジトリ内の特定のワークフローの各実行に対するユニークな番号。 この番号は、ワークフローの最初の実行時に1で始まり、新たな実行ごとにインクリメントされます。 この番号は、ワークフローの実行をやり直しても変化しません、 |
GITHUB_ACTION | アクションの一意の識別子 (id)。 |
GITHUB_ACTIONS | GitHub Actionsがワークフローを実行しているときは常にtrueに設定されます。 この変数は、テストがローカルで実行されているときと、GitHub Actionsによって実行されているときを区別するために利用できます。 |
GITHUB_ACTOR | ワークフローを開始するユーザーまたはアプリの名前。 octocatなどです。 |
GITHUB_REPOSITORY | 所有者およびリポジトリの名前。 octocat/Hello-Worldなどです。 |
GITHUB_EVENT_NAME | ワークフローをトリガーしたwebhookイベントの名前。 |
GITHUB_EVENT_PATH | 完了したwebhookイベントペイロードのファイルのパス。 /github/workflow/event.jsonなどです。 |
GITHUB_WORKSPACE | GitHubワークスペースディレクトリのパス。 ワークフローで actions/checkout アクションを使用する場合、ワークスペースディレクトリはリポジトリのコピーです。 actions/checkoutアクションを使用していない場合、ディレクトリは空となります。 たとえば、/home/runner/work/my-repo-name/my-repo-nameとなります。 |
GITHUB_SHA | ワークフローをトリガーしたコミットSHA。 たとえば、ffac537e6cbbf934b08745a378932722df287a53です。 |
GITHUB_REF | ワークフローをトリガーしたブランチまたはタグref。 たとえば、refs/heads/feature-branch-1です。 イベントタイプのブランチもタグも利用できない場合、変数は存在しません。 |
GITHUB_HEAD_REF | フォークしたリポジトリのみに設定。 headリポジトリのブランチです。 |
GITHUB_BASE_REF | フォークしたリポジトリのみに設定。 ベースリポジトリのブランチです。 |
GITHUB_SERVER_URL | GitHub Enterprise サーバーの URL を返します。 For example: https://github.com. |
GITHUB_API_URL | API URL を返します。 For example: https://api.github.com. |
GITHUB_GRAPHQL_URL | グラフ QL API の URL を返します。 For example: https://api.github.com/graphql. |
環境変数の命名規則
メモ: GitHubでは、GITHUB_という環境変数接頭辞は、GitHubが内部で使用するために予約されています。 GITHUB_接頭辞を使用して環境変数またはシークレットを設定すると、エラーになります。
ファイルシステム上の場所にそのポイントを設定した新しい環境変数がある場合は、_PATH接尾辞を指定する必要があります。 デフォルトの変数HOMEとGITHUB_WORKSPACEは、「home」および「workspace」という言葉で最初から場所がわかっているため、この規則の例外です。