Skip to main content

Enterprise Server 3.23 は、現在リリース候補として使用できます。

Skip to content

表現

ワークフローとアクションで式を評価できます。

式について

式を使用して、ワークフロー ファイルとアクセス コンテキストで環境変数をプログラムで設定できます。 式で使えるのは、リテラル値、コンテキストへの参照、関数の組み合わせです。 リテラル、コンテキストへの参照、および関数を組み合わせるには、演算子を使います。 コンテキストについて詳しくは、「コンテキスト リファレンス」をご覧ください。

式は、ステップを実行すべきか判断するための if 条件キーワードをワークフロー ファイル内に記述して使用するのが一般的です。 if 条件が true の場合は、ステップが実行されます。

ある式を、文字列型として扱うのではなく式として評価するためには、特定の構文を使って GitHub に指示する必要があります。

${{ <expression> }}

メモ

この規則の例外は、 if 句で式を使用する場合です。必要に応じて、通常は ${{ と }}を省略できます。 if 条件について詳しくは、「GitHub Actions のワークフロー構文」をご覧ください。

警告

ワークフローとアクションを作成するときは、攻撃者によってコードが信頼されていない入力を実行する可能性があるかどうかを常に考慮する必要があります。 攻撃者が悪意あるコンテンツを挿入してくるかもしれないので、特定のコンテキストは信頼できない入力として扱うべきです。 詳しくは、「セキュリティで保護された使用に関するリファレンス」をご覧ください。

環境変数の設定例

env:
  MY_ENV_VAR: ${{ <expression> }}

参考資料

ワークフローとアクションで使用できる式に関する技術リファレンス情報については、「ワークフロー内とアクション内で式を評価する」を参照してください。