GitHub Actions のワークフローコマンド

ワークフローコマンドについて

アクションは、環境変数を設定する、他のアクションに利用される値を出力する、デバッグメッセージを出力ログに追加するなどのタスクを行うため、ランナーマシンとやりとりできます。

ほとんどのワークフローコマンドが特定の形式で echo コマンドを使用しますが、他のコマンドはファイルへの書き込みによって呼び出されます。詳しくは、「環境ファイル」を参照してください。

ワークフローコマンドの例

Bash

echo "::workflow-command parameter1={data},parameter2={data}::{command value}"

echo "::workflow-command parameter1={data},parameter2={data}::{command value}"

Write-Output "::workflow-command parameter1={data},parameter2={data}::{command value}"

Write-Output "::workflow-command parameter1={data},parameter2={data}::{command value}"

注: ワークフローコマンドとパラメーター名では、大文字と小文字は区別されません。

警告: コマンドプロンプトを使用している場合は、ワークフローコマンドを使うときに二重引用符 (") を省略してください。

ワークフローコマンドを使ったツールキット関数へのアクセス

actions/toolkit には、ワークフローコマンドとして実行できる多数の関数が含まれています。 :: 構文を使用して、YAML ファイル内でワークフローコマンドを実行してください。そうすると、それらのコマンドが stdout を通じてランナーに送信されます。たとえば、コードを使用して出力を設定する代わりに、以下のようにします。

JavaScript

core.setOutput('SELECTED_COLOR', 'green');

core.setOutput('SELECTED_COLOR', 'green');

例: 値の設定

ワークフローで set-output コマンドを使用して、同じ値を設定できます。

YAML

      - name: Set selected color
        run: echo '::set-output name=SELECTED_COLOR::green'
        id: random-color-generator
      - name: Get color

        run: echo "The selected color is ${{ steps.random-color-generator.outputs.SELECTED_COLOR }}"

      - name: Set selected color
        run: echo '::set-output name=SELECTED_COLOR::green'
        id: random-color-generator
      - name: Get color

        run: echo "The selected color is ${{ steps.random-color-generator.outputs.SELECTED_COLOR }}"

YAML

      - name: Set selected color
        run: Write-Output "::set-output name=SELECTED_COLOR::green"
        id: random-color-generator
      - name: Get color

        run: Write-Output "The selected color is ${{ steps.random-color-generator.outputs.SELECTED_COLOR }}"

      - name: Set selected color
        run: Write-Output "::set-output name=SELECTED_COLOR::green"
        id: random-color-generator
      - name: Get color

        run: Write-Output "The selected color is ${{ steps.random-color-generator.outputs.SELECTED_COLOR }}"

以下の表は、ワークフロー内で使えるツールキット関数を示しています。

ツールキット関数	等価なワークフローのコマンド
`core.addPath`	`GITHUB_PATH` 環境ファイルを使用してアクセス可能
`core.debug`	`debug`
`core.notice`	`notice`
`core.error`	`error`
`core.endGroup`	`endgroup`
`core.exportVariable`	`GITHUB_ENV` 環境ファイルを使用してアクセス可能
`core.getInput`	`INPUT_{NAME}` 環境変数を使用してアクセス可能
`core.getState`	`STATE_{NAME}` 環境変数を使用してアクセス可能
`core.isDebug`	`RUNNER_DEBUG` 環境変数を使用してアクセス可能
`core.summary`	環境ファイル `GITHUB_STEP_SUMMARY` を使用してアクセス可能
`core.saveState`	`save-state` を使用してアクセス可能
`core.setCommandEcho`	`echo`
`core.setFailed`	`::error` と `exit 1` のショートカットとして使用
`core.setOutput`	`set-output` を使用してアクセス可能
`core.setSecret`	add-mask``core.startGroup

出力パラメータの設定

アクションの出力パラメータを設定します。

Text

::set-output name={name}::{value}

::set-output name={name}::{value}

あるいは、出力パラメータをアクションのメタデータファイル中で宣言することもできます。詳しくは、「GitHub Actions のメタデータ構文」を参照してください。

環境変数を作成し、ワークフローコマンドで使用することで、出力パラメーターを設定するための複数行文字列をエスケープできます。詳しくは、「環境変数の設定」を参照してください。

例: 出力パラメーターの設定

Bash

echo "::set-output name=action_fruit::strawberry"

echo "::set-output name=action_fruit::strawberry"

Write-Output "::set-output name=action_fruit::strawberry"

Write-Output "::set-output name=action_fruit::strawberry"

デバッグメッセージの設定

デバッグメッセージをログに出力します。このコマンドによって設定されたデバッグメッセージをログで表示するには、ACTIONS_STEP_DEBUG という名前のシークレットを作成し、値を true に設定する必要があります。詳しくは、「デバッグログを有効にする」を参照してください。

Text

::debug::{message}

::debug::{message}

例: デバッグメッセージの設定

Bash

echo "::debug::Set the Octocat variable"

echo "::debug::Set the Octocat variable"

Write-Output "::debug::Set the Octocat variable"

Write-Output "::debug::Set the Octocat variable"

通知メッセージの設定

通知メッセージを作成し、ログにそのメッセージを出力します。このメッセージは注釈を作成します。これにより、リポジトリ内の特定のファイルにメッセージを関連付けることができます。必要に応じて、メッセージでファイル内の位置を指定できます。

Text

::notice file={name},line={line},endLine={endLine},title={title}::{message}

::notice file={name},line={line},endLine={endLine},title={title}::{message}

パラメーター	値
`title`	カスタムタイトル
`file`	ファイル名
`col`	列番号 (1 から始まる)
`endColumn`	終わりの列番号
`line`	行番号 (1 から始まる)
`endLine`	終わりの行番号

例: 通知メッセージの設定

Bash

echo "::notice file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

echo "::notice file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

Write-Output "::notice file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

Write-Output "::notice file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

警告メッセージの設定

警告メッセージを作成し、ログにそのメッセージを出力します。このメッセージは注釈を作成します。これにより、リポジトリ内の特定のファイルにメッセージを関連付けることができます。必要に応じて、メッセージでファイル内の位置を指定できます。

Text

::warning file={name},line={line},endLine={endLine},title={title}::{message}

::warning file={name},line={line},endLine={endLine},title={title}::{message}

パラメーター	値
`title`	カスタムタイトル
`file`	ファイル名
`col`	列番号 (1 から始まる)
`endColumn`	終わりの列番号
`line`	行番号 (1 から始まる)
`endLine`	終わりの行番号

例: 警告メッセージの設定

Bash

echo "::warning file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

echo "::warning file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

Write-Output "::warning file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

Write-Output "::warning file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

エラーメッセージの設定

エラーメッセージを作成し、ログにそのメッセージを出力します。このメッセージは注釈を作成します。これにより、リポジトリ内の特定のファイルにメッセージを関連付けることができます。必要に応じて、メッセージでファイル内の位置を指定できます。

Text

::error file={name},line={line},endLine={endLine},title={title}::{message}

::error file={name},line={line},endLine={endLine},title={title}::{message}

パラメーター	値
`title`	カスタムタイトル
`file`	ファイル名
`col`	列番号 (1 から始まる)
`endColumn`	終わりの列番号
`line`	行番号 (1 から始まる)
`endLine`	終わりの行番号

例: エラーメッセージの設定

Bash

echo "::error file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

echo "::error file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

Write-Output "::error file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

Write-Output "::error file=app.js,line=1,col=5,endColumn=7::Missing semicolon"

ログの行のグループ化

展開可能なグループをログ中に作成します。グループを作成するには、group コマンドを使用して title を指定します。ログに出力する group と endgroup コマンド間のすべての内容は、ログで展開可能なエントリ内で入れ子になります。

Text

::group::{title}
::endgroup::

::group::{title}
::endgroup::

例: ログの行のグループ化

YAML

jobs:
  bash-example:
    runs-on: ubuntu-latest
    steps:
      - name: Group of log lines
        run: |
            echo "::group::My title"
            echo "Inside group"
            echo "::endgroup::"

jobs:
  bash-example:
    runs-on: ubuntu-latest
    steps:
      - name: Group of log lines
        run: |
            echo "::group::My title"
            echo "Inside group"
            echo "::endgroup::"

YAML

jobs:
  powershell-example:
    runs-on: windows-latest
    steps:
      - name: Group of log lines
        run: |
            Write-Output "::group::My title"
            Write-Output "Inside group"
            Write-Output "::endgroup::"

jobs:
  powershell-example:
    runs-on: windows-latest
    steps:
      - name: Group of log lines
        run: |
            Write-Output "::group::My title"
            Write-Output "Inside group"
            Write-Output "::endgroup::"

ワークフローステップのログのスクリーンショット。 2 行目の "My title" の前に下向きの矢印があり、グループが展開されていることを示しています。次の行の "Inside group" は、下にインデントされています。

ログ中の値のマスク

Text

::add-mask::{value}

::add-mask::{value}

値をマスクすることにより、文字列または値がログに出力されることを防ぎます。空白で区切られた、マスクされる各単語は、* という文字に置き換えられます。マスクの value には、環境変数または文字列を使用できます。値をマスクすると、シークレットとして扱われ、ランナーで編集されます。たとえば、値をマスクした後は、その値を出力として設定することはできません。

例: 文字列のマスク

ログに "Mona The Octocat" を出力すると、"***" と表示されます。

Bash

echo "::add-mask::Mona The Octocat"

echo "::add-mask::Mona The Octocat"

Write-Output "::add-mask::Mona The Octocat"

Write-Output "::add-mask::Mona The Octocat"

警告: シークレットをビルドログに出力したり、その他のワークフローコマンド内で使ったりする前に、シークレットを "add-mask" に必ず登録してください。

例: 環境変数のマスク

ログに変数 MY_NAME または値 "Mona The Octocat" を出力すると、"Mona The Octocat" の代わりに "***" と表示されます。

YAML

jobs:
  bash-example:
    runs-on: ubuntu-latest
    env:
      MY_NAME: "Mona The Octocat"
    steps:
      - name: bash-version
        run: echo "::add-mask::$MY_NAME"

jobs:
  bash-example:
    runs-on: ubuntu-latest
    env:
      MY_NAME: "Mona The Octocat"
    steps:
      - name: bash-version
        run: echo "::add-mask::$MY_NAME"

YAML

jobs:
  powershell-example:
    runs-on: windows-latest
    env:
      MY_NAME: "Mona The Octocat"
    steps:
      - name: powershell-version
        run: Write-Output "::add-mask::$env:MY_NAME"

jobs:
  powershell-example:
    runs-on: windows-latest
    env:
      MY_NAME: "Mona The Octocat"
    steps:
      - name: powershell-version
        run: Write-Output "::add-mask::$env:MY_NAME"

例: 1 つのジョブ内での生成された出力のマスク

**注**: `add-mask` を使ってから、`set-output` を使う必要があります。それ以外の場合、出力はマスクされません。

1 つのジョブから別のジョブにシークレットを渡す必要がない場合は、次を行うことができます。

シークレットを生成する (出力は行いません)。
add-mask を使ってマスクする。
set-output を使って、ジョブ内の他のステップにシークレットを使えるようにする。

YAML

on: push
jobs:
  generate-a-secret-output:
    runs-on: ubuntu-latest
    steps:
      - id: sets-a-secret
        name: Generate, mask, and output a secret
        run: |
          the_secret=$((RANDOM))
          echo "::add-mask::$the_secret"
          echo "::set-output name=secret-number::$the_secret"
      - name: Use that secret output (protected by a mask)
        run: |
          echo "the secret number is ${{ steps.sets-a-secret.outputs.secret-number }}"

on: push
jobs:
  generate-a-secret-output:
    runs-on: ubuntu-latest
    steps:
      - id: sets-a-secret
        name: Generate, mask, and output a secret
        run: |
          the_secret=$((RANDOM))
          echo "::add-mask::$the_secret"
          echo "::set-output name=secret-number::$the_secret"
      - name: Use that secret output (protected by a mask)
        run: |
          echo "the secret number is ${{ steps.sets-a-secret.outputs.secret-number }}"

YAML

on: push
jobs:
  generate-a-secret-output:
    runs-on: ubuntu-latest
    steps:
      - id: sets-a-secret
        name: Generate, mask, and output a secret
        shell: pwsh
        run: |
          Set-Variable -Name TheSecret -Value (Get-Random)
          Write-Output "::add-mask::$TheSecret"
          Write-Output "::set-output name=secret-number::$TheSecret"
      - name: Use that secret output (protected by a mask)
        shell: pwsh
        run: |
          Write-Output "the secret number is ${{ steps.sets-a-secret.outputs.secret-number }}"

on: push
jobs:
  generate-a-secret-output:
    runs-on: ubuntu-latest
    steps:
      - id: sets-a-secret
        name: Generate, mask, and output a secret
        shell: pwsh
        run: |
          Set-Variable -Name TheSecret -Value (Get-Random)
          Write-Output "::add-mask::$TheSecret"
          Write-Output "::set-output name=secret-number::$TheSecret"
      - name: Use that secret output (protected by a mask)
        shell: pwsh
        run: |
          Write-Output "the secret number is ${{ steps.sets-a-secret.outputs.secret-number }}"

例: ジョブまたはワークフロー間でのシークレットのマスクと引き渡し

マスクされたシークレットをジョブまたはワークフロー間で渡す場合は、そのシークレットをストアに格納してから後続のジョブまたはワークフローで取得する必要があります。

セットアップ

ワークフロー中に生成するシークレットを格納するようにシークレットストアを設定します。たとえば、Vault です。
そのシークレットストアに対する読み取りと書き込みのキーを生成します。キーをリポジトリシークレットとして格納します。次のワークフロー例では、シークレット名は SECRET_STORE_CREDENTIALS です。詳しくは、「GitHub Actions でのシークレットの使用」を参照してください。

ワークフロー

注: このワークフローには、架空のシークレットストアである secret-store を使います。これには、架空のコマンドである store-secret と retrieve-secret が含まれています。 some/secret-store@ 27b31702a0e7fc50959f5ad993c78deac1bdfc29 は架空のアクションです。これを実行すると、secret-store アプリケーションがインストールされ、instance と credentials に接続するように構成されます。

YAML

on: push

jobs:
  secret-generator:
    runs-on: ubuntu-latest
    steps:
    - uses: some/secret-store@v1
      with:
        credentials: ${{ secrets.SECRET_STORE_CREDENTIALS }}
        instance: ${{ secrets.SECRET_STORE_INSTANCE }}
    - name: generate secret
      shell: bash
      run: |
        GENERATED_SECRET=$((RANDOM))
        echo "::add-mask::$GENERATED_SECRET"
        SECRET_HANDLE=$(secret-store store-secret "$GENERATED_SECRET")
        echo "::set-output name=handle::$secret_handle"
  secret-consumer:
    runs-on: macos-latest
    needs: secret-generator
    steps:
    - uses: some/secret-store@v1
      with:
        credentials: ${{ secrets.SECRET_STORE_CREDENTIALS }}
        instance: ${{ secrets.SECRET_STORE_INSTANCE }}
    - name: use secret
      shell: bash
      run: |
        SECRET_HANDLE="${{ needs.secret-generator.outputs.handle }}"
        RETRIEVED_SECRET=$(secret-store retrieve-secret "$SECRET_HANDLE")
        echo "::add-mask::$RETRIEVED_SECRET"
        echo "We retrieved our masked secret: $RETRIEVED_SECRET"

on: push

jobs:
  secret-generator:
    runs-on: ubuntu-latest
    steps:
    - uses: some/secret-store@v1
      with:
        credentials: ${{ secrets.SECRET_STORE_CREDENTIALS }}
        instance: ${{ secrets.SECRET_STORE_INSTANCE }}
    - name: generate secret
      shell: bash
      run: |
        GENERATED_SECRET=$((RANDOM))
        echo "::add-mask::$GENERATED_SECRET"
        SECRET_HANDLE=$(secret-store store-secret "$GENERATED_SECRET")
        echo "::set-output name=handle::$secret_handle"
  secret-consumer:
    runs-on: macos-latest
    needs: secret-generator
    steps:
    - uses: some/secret-store@v1
      with:
        credentials: ${{ secrets.SECRET_STORE_CREDENTIALS }}
        instance: ${{ secrets.SECRET_STORE_INSTANCE }}
    - name: use secret
      shell: bash
      run: |
        SECRET_HANDLE="${{ needs.secret-generator.outputs.handle }}"
        RETRIEVED_SECRET=$(secret-store retrieve-secret "$SECRET_HANDLE")
        echo "::add-mask::$RETRIEVED_SECRET"
        echo "We retrieved our masked secret: $RETRIEVED_SECRET"

YAML

on: push

jobs:
  secret-generator:
    runs-on: ubuntu-latest
    steps:
    - uses: some/secret-store@v1
      with:
        credentials: ${{ secrets.SECRET_STORE_CREDENTIALS }}
        instance: ${{ secrets.SECRET_STORE_INSTANCE }}
    - name: generate secret
      shell: pwsh
      run: |
        Set-Variable -Name Generated_Secret -Value (Get-Random)
        Write-Output "::add-mask::$Generated_Secret"
        Set-Variable -Name Secret_Handle -Value (Store-Secret "$Generated_Secret")
        Write-Output "::set-output name=handle::$Secret_Handle"
  secret-consumer:
    runs-on: macos-latest
    needs: secret-generator
    steps:
    - uses: some/secret-store@v1
      with:
        credentials: ${{ secrets.SECRET_STORE_CREDENTIALS }}
        instance: ${{ secrets.SECRET_STORE_INSTANCE }}
    - name: use secret
      shell: pwsh
      run: |
        Set-Variable -Name Secret_Handle -Value "${{ needs.secret-generator.outputs.handle }}"
        Set-Variable -Name Retrieved_Secret -Value (Retrieve-Secret "$Secret_Handle")
        echo "::add-mask::$Retrieved_Secret"
        echo "We retrieved our masked secret: $Retrieved_Secret"

on: push

jobs:
  secret-generator:
    runs-on: ubuntu-latest
    steps:
    - uses: some/secret-store@v1
      with:
        credentials: ${{ secrets.SECRET_STORE_CREDENTIALS }}
        instance: ${{ secrets.SECRET_STORE_INSTANCE }}
    - name: generate secret
      shell: pwsh
      run: |
        Set-Variable -Name Generated_Secret -Value (Get-Random)
        Write-Output "::add-mask::$Generated_Secret"
        Set-Variable -Name Secret_Handle -Value (Store-Secret "$Generated_Secret")
        Write-Output "::set-output name=handle::$Secret_Handle"
  secret-consumer:
    runs-on: macos-latest
    needs: secret-generator
    steps:
    - uses: some/secret-store@v1
      with:
        credentials: ${{ secrets.SECRET_STORE_CREDENTIALS }}
        instance: ${{ secrets.SECRET_STORE_INSTANCE }}
    - name: use secret
      shell: pwsh
      run: |
        Set-Variable -Name Secret_Handle -Value "${{ needs.secret-generator.outputs.handle }}"
        Set-Variable -Name Retrieved_Secret -Value (Retrieve-Secret "$Secret_Handle")
        echo "::add-mask::$Retrieved_Secret"
        echo "We retrieved our masked secret: $Retrieved_Secret"

ワークフローコマンドの停止と開始

ワークフローコマンドの処理を停止します。この特殊コマンドを使うと、意図せずワークフローコマンドを実行することなくいかなるログも取れます。たとえば、コメントがあるスクリプト全体を出力するためにログ取得を停止できます。

Text

::stop-commands::{endtoken}

::stop-commands::{endtoken}

ワークフローコマンドの処理を停止するには、固有のトークンを stop-commands に渡します。ワークフローコマンドの処理を再開するには、ワークフローコマンドを停止するために使用したトークンと同じものを渡します。

警告: ランダムに生成された、実行ごとに固有のトークンを使用するようにしてください。

Text

::{endtoken}::

::{endtoken}::

例: ワークフローコマンドの停止と開始

YAML

jobs:
  workflow-command-job:
    runs-on: ubuntu-latest
    steps:
      - name: Disable workflow commands
        run: |
          echo '::warning:: This is a warning message, to demonstrate that commands are being processed.'
          stopMarker=$(uuidgen)
          echo "::stop-commands::$stopMarker"
          echo '::warning:: This will NOT be rendered as a warning, because stop-commands has been invoked.'
          echo "::$stopMarker::"
          echo '::warning:: This is a warning again, because stop-commands has been turned off.'

jobs:
  workflow-command-job:
    runs-on: ubuntu-latest
    steps:
      - name: Disable workflow commands
        run: |
          echo '::warning:: This is a warning message, to demonstrate that commands are being processed.'
          stopMarker=$(uuidgen)
          echo "::stop-commands::$stopMarker"
          echo '::warning:: This will NOT be rendered as a warning, because stop-commands has been invoked.'
          echo "::$stopMarker::"
          echo '::warning:: This is a warning again, because stop-commands has been turned off.'

YAML

jobs:
  workflow-command-job:
    runs-on: windows-latest
    steps:
      - name: Disable workflow commands
        run: |
          Write-Output '::warning:: This is a warning message, to demonstrate that commands are being processed.'
          $stopMarker = New-Guid
          Write-Output "::stop-commands::$stopMarker"
          Write-Output '::warning:: This will NOT be rendered as a warning, because stop-commands has been invoked.'
          Write-Output "::$stopMarker::"
          Write-Output '::warning:: This is a warning again, because stop-commands has been turned off.'

jobs:
  workflow-command-job:
    runs-on: windows-latest
    steps:
      - name: Disable workflow commands
        run: |
          Write-Output '::warning:: This is a warning message, to demonstrate that commands are being processed.'
          $stopMarker = New-Guid
          Write-Output "::stop-commands::$stopMarker"
          Write-Output '::warning:: This will NOT be rendered as a warning, because stop-commands has been invoked.'
          Write-Output "::$stopMarker::"
          Write-Output '::warning:: This is a warning again, because stop-commands has been turned off.'

コマンド出力のエコー

ワークフローコマンドのエコーを有効または無効にします。たとえば、ワークフローで set-output コマンドを使用すると、出力パラメーターが設定されますが、ワークフロー実行のログにはコマンド自体は表示されません。コマンドのエコーを有効にした場合、::set-output name={name}::{value} のようにコマンドがログに表示されます。

Text

::echo::on
::echo::off

::echo::on
::echo::off

コマンドのエコーは既定では無効になっています。ただし、コマンドの処理中にエラーが発生した場合は、ワークフローコマンドがエコーされます。

add-mask、debug、warning、error コマンドは、出力が既にログにエコーされるようになっているため、エコーをサポートしていません。

ACTIONS_STEP_DEBUG シークレットを使用してステップのデバッグログを有効にすることで、コマンドのエコーをグローバルに有効にすることもできます。詳細については、「デバッグログを有効にする」を参照してください。対照的に、echo ワークフローコマンドを使用すると、リポジトリ内のすべてのワークフローに対してコマンドのエコーを有効にするのではなく、より詳細なレベルで有効にすることができます。

例: コマンドのエコーの切り替え

YAML

jobs:
  workflow-command-job:
    runs-on: ubuntu-latest
    steps:
      - name: toggle workflow command echoing
        run: |
          echo '::set-output name=action_echo::disabled'
          echo '::echo::on'
          echo '::set-output name=action_echo::enabled'
          echo '::echo::off'
          echo '::set-output name=action_echo::disabled'

jobs:
  workflow-command-job:
    runs-on: ubuntu-latest
    steps:
      - name: toggle workflow command echoing
        run: |
          echo '::set-output name=action_echo::disabled'
          echo '::echo::on'
          echo '::set-output name=action_echo::enabled'
          echo '::echo::off'
          echo '::set-output name=action_echo::disabled'

YAML

jobs:
  workflow-command-job:
    runs-on: windows-latest
    steps:
      - name: toggle workflow command echoing
        run: |
          write-output "::set-output name=action_echo::disabled"
          write-output "::echo::on"
          write-output "::set-output name=action_echo::enabled"
          write-output "::echo::off"
          write-output "::set-output name=action_echo::disabled"

jobs:
  workflow-command-job:
    runs-on: windows-latest
    steps:
      - name: toggle workflow command echoing
        run: |
          write-output "::set-output name=action_echo::disabled"
          write-output "::echo::on"
          write-output "::set-output name=action_echo::enabled"
          write-output "::echo::off"
          write-output "::set-output name=action_echo::disabled"

上記の例では、次の行がログに出力されます。

Text

::set-output name=action_echo::enabled
::echo::off

::set-output name=action_echo::enabled
::echo::off

ログには 2 番目の set-output と echo ワークフローコマンドのみが含まれています。これは、それらのコマンドが実行されたときにのみコマンドのエコーが有効になったからです。出力パラメーターは、常にエコーされるとは限りませんが、すべての場合において設定されます。

pre及びpostアクションへの値の送信

save-state コマンドを使用して、ワークフローの pre:または post: アクションと共有するための環境変数を作成できます。たとえば、pre: アクションでファイルを作成し、そのファイルの場所を main: アクションに渡し、post: アクションを使用してファイルを削除できます。あるいは、main: アクションでファイルを作成し、そのファイルの場所を post: アクションに渡し、さらに post: アクションを使用してファイルを削除することもできます。

複数の pre: または post: アクションがある場合は、save-state が使用されたアクションで保存された値にのみアクセスできます。 post: アクションの詳細については、「GitHub Actions のメタデータ構文」を参照してください。

save-state コマンドはアクション内でのみ実行でき、YAML ファイルでは使用できません。保存された値は、STATE_ というプレフィックスが付いた環境変数として保存されます。

この例では、JavaScript を使用して save-state コマンドを実行します。結果の環境変数は、STATE_processID という名前になり、値が 12345 になります。

JavaScript

console.log('::save-state name=processID::12345')

console.log('::save-state name=processID::12345')

この後、STATE_processID 変数は main アクションで実行されるクリーンアップスクリプトでのみ利用できます。この例は main で実行され、JavaScript を使用して STATE_processID 環境変数に割り当てられた値を表示します。

JavaScript

console.log("The running PID from the main action is: " +  process.env.STATE_processID);

console.log("The running PID from the main action is: " +  process.env.STATE_processID);

環境ファイル

ワークフローの実行中に、ランナーは特定のアクションを実行する際に使用できる一時ファイルを生成します。これらのファイルへのパスは、環境変数を介して公開されます。コマンドを適切に処理するには、これらのファイルに書き込むときに UTF-8 エンコーディングを使用する必要があります。複数のコマンドを、改行で区切って同じファイルに書き込むことができます。

注: PowerShell バージョン 5.1 以下 (shell: powershell) では UTF-8 が既定で使用されないため、UTF-8 エンコードを指定する必要があります。次に例を示します。

YAML

jobs:
  legacy-powershell-example:
    runs-on: windows-latest
    steps:
      - shell: powershell
        run: |
          "mypath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append

jobs:
  legacy-powershell-example:
    runs-on: windows-latest
    steps:
      - shell: powershell
        run: |
          "mypath" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append

PowerShell Core バージョン 6 以上 (shell: pwsh) では、UTF-8 が既定で使用されます。次に例を示します。

YAML

jobs:
  powershell-core-example:
    runs-on: windows-latest
    steps:
      - shell: pwsh
        run: |
          "mypath" | Out-File -FilePath $env:GITHUB_PATH -Append

jobs:
  powershell-core-example:
    runs-on: windows-latest
    steps:
      - shell: pwsh
        run: |
          "mypath" | Out-File -FilePath $env:GITHUB_PATH -Append

環境変数の設定

注: 問題を回避するには、使用しているオペレーティングシステムとシェルの動作に関係なく、環境変数を大文字と小文字を区別するものとして扱うことをお勧めします。

Bash

echo "{environment_variable_name}={value}" >> "$GITHUB_ENV"

echo "{environment_variable_name}={value}" >> "$GITHUB_ENV"

PowerShell バージョン 6 以上を使用:

"{environment_variable_name}={value}" | Out-File -FilePath $env:GITHUB_ENV -Append

"{environment_variable_name}={value}" | Out-File -FilePath $env:GITHUB_ENV -Append

PowerShell バージョン 5.1 以下を使用:

PowerShell

"{environment_variable_name}={value}" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append

"{environment_variable_name}={value}" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append

環境変数を定義または更新し、これを GITHUB_ENV 環境ファイルに書き込むことで、ワークフロージョブの後続のステップで環境変数が利用できるようになります。環境変数を作成または更新するステップは、新しい値にアクセスできませんが、ジョブにおける後続のすべてのステップはアクセスできます。

GITHUB_* および RUNNER_* という名前の既定の環境変数の値を上書きすることはできません。現時点では、CI 変数の値を上書きできます。ただし、これが常に可能になることは保証されていません。既定の環境変数の詳細については、「変数」を参照してください。

環境変数を `GITHUB_ENV` に書き込む例

YAML

steps:
  - name: Set the value
    id: step_one
    run: |
      echo "action_state=yellow" >> "$GITHUB_ENV"
  - name: Use the value
    id: step_two
    run: |
      printf '%s\n' "$action_state" # This will output 'yellow'

steps:
  - name: Set the value
    id: step_one
    run: |
      echo "action_state=yellow" >> "$GITHUB_ENV"
  - name: Use the value
    id: step_two
    run: |
      printf '%s\n' "$action_state" # This will output 'yellow'

YAML

steps:
  - name: Set the value
    id: step_one
    run: |
      "action_state=yellow" | Out-File -FilePath $env:GITHUB_ENV -Append
  - name: Use the value
    id: step_two
    run: |
      Write-Output "$env:action_state" # This will output 'yellow'

steps:
  - name: Set the value
    id: step_one
    run: |
      "action_state=yellow" | Out-File -FilePath $env:GITHUB_ENV -Append
  - name: Use the value
    id: step_two
    run: |
      Write-Output "$env:action_state" # This will output 'yellow'

複数行の文字列

複数行の文字列の場合、次の構文で区切り文字を使用できます。

Text

{name}<<{delimiter}
{value}
{delimiter}

{name}<<{delimiter}
{value}
{delimiter}

警告: 使用している区切り記号が、値内の行自体に含まれないことを確認します。値が完全に任意の場合は、この形式を使用しないでください。代わりに、値をファイルに書き込みます。

複数行文字列の例

この例では、区切り文字として EOF を使用し、JSON_RESPONSE 環境変数を curl の応答の値に設定します。

YAML

steps:
  - name: Set the value in bash
    id: step_one
    run: |
      {
        echo 'JSON_RESPONSE<<EOF'
        curl https://example.com
        echo EOF
      } >> "$GITHUB_ENV"

steps:
  - name: Set the value in bash
    id: step_one
    run: |
      {
        echo 'JSON_RESPONSE<<EOF'
        curl https://example.com
        echo EOF
      } >> "$GITHUB_ENV"

YAML

steps:
  - name: Set the value in pwsh
    id: step_one
    run: |
      $EOF = -join (1..15 | ForEach {[char]((48..57)+(65..90)+(97..122) | Get-Random)})
      "JSON_RESPONSE<<$EOF" | Out-File -FilePath $env:GITHUB_ENV -Append
      (Invoke-WebRequest -Uri "https://example.com").Content | Out-File -FilePath $env:GITHUB_ENV -Append
      "$EOF" | Out-File -FilePath $env:GITHUB_ENV -Append
    shell: pwsh

steps:
  - name: Set the value in pwsh
    id: step_one
    run: |
      $EOF = -join (1..15 | ForEach {[char]((48..57)+(65..90)+(97..122) | Get-Random)})
      "JSON_RESPONSE<<$EOF" | Out-File -FilePath $env:GITHUB_ENV -Append
      (Invoke-WebRequest -Uri "https://example.com").Content | Out-File -FilePath $env:GITHUB_ENV -Append
      "$EOF" | Out-File -FilePath $env:GITHUB_ENV -Append
    shell: pwsh

ジョブの概要の追加

Bash

echo "{markdown content}" >> $GITHUB_STEP_SUMMARY

echo "{markdown content}" >> $GITHUB_STEP_SUMMARY

"{markdown content}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append

"{markdown content}" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append

ジョブごとにいくつかのカスタム Markdown を設定して、ワークフロー実行の概要ページに表示されるようにすることができます。ジョブの概要を使用して、テスト結果の概要といった独自の内容を表示およびグループ化できます。これにより、ワークフロー実行の結果を表示するユーザーが、実行に関連する重要な情報 (エラーなど) を確認するためにログを調べる必要がなくなります。

ジョブの概要では GitHub Flavored Markdown がサポートされていて、ステップの Markdown コンテンツを GITHUB_STEP_SUMMARY 環境ファイルに追加できます。 GITHUB_STEP_SUMMARY は、ジョブのステップごとに固有のものです。 GITHUB_STEP_SUMMARY が参照するステップごとのファイルについて詳しくは、「環境ファイル」をご覧ください。

ジョブが完了すると、ジョブにおけるすべてのステップの概要が 1 つのジョブの概要にグループ化され、ワークフロー実行の概要ページに表示されます。複数のジョブが概要を生成する場合、ジョブの概要の順序はジョブの完了時間順になります。

ジョブの概要の追加例

Bash

echo "### Hello world! :rocket:" >> $GITHUB_STEP_SUMMARY

echo "### Hello world! :rocket:" >> $GITHUB_STEP_SUMMARY

"### Hello world! :rocket:" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append

"### Hello world! :rocket:" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append

ワークフロー実行時の概要ページのスクリーンショット。 "example summary" の下に "Hello world!" とロケットの絵文字があります。

複数行の Markdown コンテンツ

複数行の Markdown コンテンツの場合は、>> を使用して、現在のステップのコンテンツを連続して追加できます。追加操作のたびに、改行文字が自動的に追加されます。

複数行の Markdown コンテンツの例

- name: Generate list using Markdown
  run: |
    echo "This is the lead in sentence for the list" >> $GITHUB_STEP_SUMMARY
    echo "" >> $GITHUB_STEP_SUMMARY # this is a blank line
    echo "- Lets add a bullet point" >> $GITHUB_STEP_SUMMARY
    echo "- Lets add a second bullet point" >> $GITHUB_STEP_SUMMARY
    echo "- How about a third one?" >> $GITHUB_STEP_SUMMARY

- name: Generate list using Markdown
  run: |
    "This is the lead in sentence for the list" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append
    "" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append # this is a blank line
    "- Lets add a bullet point" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append
    "- Lets add a second bullet point" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append
    "- How about a third one?" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append

ジョブの概要の上書き

現在のステップのすべてのコンテンツをクリアするには、> を使用して、Bash で以前に追加したコンテンツを上書きするか、PowerShell で -Append を削除します。

ジョブの概要の上書き例

- name: Overwrite Markdown
  run: |
    echo "Adding some Markdown content" >> $GITHUB_STEP_SUMMARY
    echo "There was an error, we need to clear the previous Markdown with some new content." > $GITHUB_STEP_SUMMARY

- name: Overwrite Markdown
  run: |
    "Adding some Markdown content" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append
    "There was an error, we need to clear the previous Markdown with some new content." | Out-File -FilePath $env:GITHUB_STEP_SUMMARY

ジョブの概要の削除

現在のステップの概要を完全に削除するには、GITHUB_STEP_SUMMARY が参照するファイルを削除します。

ジョブの概要の削除例

- name: Delete all summary content
  run: |
    echo "Adding Markdown content that we want to remove before the step ends" >> $GITHUB_STEP_SUMMARY
    rm $GITHUB_STEP_SUMMARY

- name: Delete all summary content
  run: |
    "Adding Markdown content that we want to remove before the step ends" | Out-File -FilePath $env:GITHUB_STEP_SUMMARY -Append
    Remove-Item $env:GITHUB_STEP_SUMMARY

ステップが完了すると、ジョブの概要がアップロードされ、後続のステップは以前にアップロードされた Markdown コンテンツを変更できません。概要では、誤って追加された可能性があるシークレットが自動的にマスクされます。ジョブの概要に削除する必要がある機密情報が含まれている場合は、ワークフロー実行全体を削除して、そのジョブの概要をすべて削除できます。詳細については、「ワークフロー実行の削除」を参照してください。

ステップの分離と制限

ジョブの概要はステップ間で分離されていて、各ステップのサイズは最大 1 MiB に制限されています。分離がステップ間で適用されるため、1 つのステップにおいて Markdown の形式が誤っている可能性があっても、後続のステップで Markdown のレンダリングが中断することはありません。ステップに 1 MiB を超えるコンテンツが追加された場合、ステップのアップロードは失敗し、エラーの注釈が作成されます。ジョブの概要のアップロードエラーは、ステップまたはジョブの全体的な状態には影響しません。ジョブごとに、ステップのジョブの概要が最大 20 件表示されます。

システムパスの追加

システムの PATH 変数の先頭にディレクトリを追加し、自動的に現在のジョブにおける後続のすべてのアクションで利用できるようにします。現在実行中のアクションは、更新されたパス変数にアクセスできません。ジョブに現在定義されているパスを確認するには、ステップまたはアクションで echo "$PATH" を使うことができます。

Bash

echo "{path}" >> $GITHUB_PATH

echo "{path}" >> $GITHUB_PATH

"{path}" | Out-File -FilePath $env:GITHUB_PATH -Append

"{path}" | Out-File -FilePath $env:GITHUB_PATH -Append

システムパスの追加例

この例では、ユーザーの $HOME/.local/bin ディレクトリを PATH に追加する方法を示しています。

Bash

echo "$HOME/.local/bin" >> $GITHUB_PATH

echo "$HOME/.local/bin" >> $GITHUB_PATH

この例では、ユーザーの $env:HOMEPATH/.local/bin ディレクトリを PATH に追加する方法を示しています。

"$env:HOMEPATH/.local/bin" | Out-File -FilePath $env:GITHUB_PATH -Append

"$env:HOMEPATH/.local/bin" | Out-File -FilePath $env:GITHUB_PATH -Append

GitHub Actions のワークフロー コマンド

この記事の内容

Tool navigation

GitHub Actions のワークフローコマンド