式について
式を使用して、ワークフロー ファイルとアクセス コンテキストで環境変数をプログラムで設定できます。 式で使えるのは、リテラル値、コンテキストへの参照、関数の組み合わせです。 リテラル、コンテキストへの参照、および関数を組み合わせるには、演算子を使います。 コンテキストについて詳しくは、「Contexts reference」をご覧ください。
式は、ステップを実行すべきか判断するための if
条件キーワードをワークフロー ファイル内に記述して使用するのが一般的です。 if
条件が true
の場合は、ステップが実行されます。
ある式を、文字列型として扱うのではなく式として評価するためには、特定の構文を使って GitHub に指示する必要があります。
${{ <expression> }}
メモ
この規則の例外は、if
句で式を使用する場合です。通常、${{
と }}
を任意で省略することができます。 if
条件について詳しくは、「Workflow syntax for GitHub Actions」をご覧ください。
警告
ワークフローとアクションを作成するときは、攻撃者によってコードが信頼されていない入力を実行する可能性があるかどうかを常に考慮する必要があります。 攻撃者が悪意あるコンテンツを挿入してくるかもしれないので、特定のコンテキストは信頼できない入力として扱うべきです。 詳しくは、「Secure use reference」をご覧ください。
環境変数の設定例
env:
MY_ENV_VAR: ${{ <expression> }}
参考資料
ワークフローとアクションで使用できる式に関する技術リファレンス情報については、「Evaluate expressions in workflows and actions」を参照してください。