λ沢.dev

on:
  workflow_call:
    inputs:
      username:
        required: true
        type: string
    secrets:
      PAT:
        required: true

jobs:
  callee:
    runs-on: ubuntu-latest
    steps:
      - run: echo "${{ inputs.username }} ${{ secrets.PAT }}"

呼び出し側 (.github/workflows/foo.yml)

on: # ... 省略 ...

jobs:
  foo:
    uses: ./.github/workflows/workflow-call-callee.yml
    with:
      username: alice
    secrets:
      PAT: alice-secret

composite action

https://docs.github.com/en/actions/creating-actions/creating-a-composite-action

複数の step を組みわせて一つの action.yml として扱うことができる。呼び出し側は step の users に action.yml のディレクトリを渡すことができる。

呼び出される側 (custom-action/composite/action.yml)

name: "My Composite Action"
description: "Execute awesome steps"
inputs:
  name:
    required: true
    default: "world"
outputs:
  time:
    value: ${{ steps.now.outputs.time }}
runs:
  using: "composite"
  steps:
    - run: echo Hello ${{ inputs.name }}.
      shell: bash

    - id: now
      run: echo "::set-output name=time::$(date +%s)"
      shell: bash

呼び出し側 (.github/workflows/foo.yml)

on: # ... 省略 ....

jobs:
  foo:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      - id: hello
        uses: ./custom-action/composite
        with:
          name: "lambdasawa"

      - run: echo "${{ steps.hello.outputs.time }}"

on: workflow_run

https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#workflow_run

このトリガーを設定しておくと他のワークフローの開始か終了をトリガーにしたワークフローを作成できる。終了をトリガーにする場合、 github.event.workflow_run.conclusion を参照することでトリガー元のワークフローが成功したか失敗したかを判断できる。

呼び出される側 (.github/workflows/foo.yml)

on:
  workflow_run:
    workflows: [workflow-run-source]
    types:
      - completed

jobs:
  foo:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      - run: echo "Hello, ${{ github.event.workflow_run.conclusion }}"

呼び出す側 (.github/workflows/bar.yml)

name: workflow-run-source

on: # … 省略 ...

jobs:
  foo:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2

      - run: echo "Hello, world!"

on: repository_dispatch

https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#repository_dispatch https://docs.github.com/en/rest/reference/repos#create-a-repository-dispatch-event

このトリガーを設定しておくと GitHub の API 経由でワークフローを起動できる。 Personal Access Token か GitHub App 経由で呼び出せる。

on:
  repository_dispatch:
    types: [my-type]

jobs:
  foo:
    runs-on: ubuntu-latest
    steps:
      - run: echo $VALUE
        env:
          VALUE: ${{ github.event.client_payload.value }}

gh api コマンドで PAT を使って呼び出す例

echo '{"event_type": "my-type", "client_payload": {"value": 42}}' |
  gh api \
    -X POST \
    /repos/lambdasawa/github-actions-sandbox/dispatches \
    -H 'Accept: application/vnd.github.v3.raw+json' \
    --input -

on: workflow_dispatch

https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows#workflow_dispatch

このトリガーを設定しておくと GitHub の Actions のページか gh コマンドから手動でワークフローを起動できる。

on:
  workflow_dispatch:
    inputs:
      stringValue:
        description: "desc1"
      booleanValue:
        description: "desc2"
        required: true
        type: boolean
      choiceValue:
        description: "desc3"
        required: true
        default: "green"
        type: choice
        options:
          - red
          - green
          - blue
      envValue:
        description: "desc4"
        type: environment
        required: true

jobs:
  foo:
    runs-on: ubuntu-latest
    environment: ${{ github.event.inputs.envValue }}
    steps:
      - run: |
          echo ${{ github.event.inputs.stringValue }}
          echo ${{ github.event.inputs.booleanValue }}
          echo ${{ github.event.inputs.choiceValue }}
          echo ${{ github.event.inputs.envValue }}

gh workflow run コマンドで呼び出す例

gh workflow run workflow-dispatch.yml -f stringValue=foo -f booleanValue=true -f envValue=develop

environment

https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idenvironment

レポジトリごとに環境を複数登録できる。それぞれの環境は異なるシークレットを設定できる。

name: environment-staging

on:
  workflow_dispatch:

jobs:
  build:
    runs-on: ubuntu-latest
    environment: staging # ここで環境を指定する
    steps:
      - uses: actions/checkout@v2
      - run: |
          echo "$MY_SECRET" | sha256sum
        env:
          MY_SECRET: ${{ secrets.MY_SECRET }}

https://github.com/actions/github-script

ワークフローのステップを JS で書ける。 GitHub の API を叩いたり (github を使う)、ワークフローコマンド相当の処理をしたり (core を使う) するのが楽。

refactor workflow

ワークフロー内にあるパラメータを少し変えて複数パターンで実行したい場合は workflow_call が使える
ワークフローの開始か終了をトリガーにして別のワークフローを起動をする場合は workflow_run が使える
あるワークフローから別のワークフローの一部分のステップだけを使いたい場合は、そのステップを composite action として切り出せる
secrets.GITHUB_TOKEN を使って git push, gh pr merge しても push のトリガーは発火しない
同様に secrets.GITHUB_TOKEN を使って gh workflow run しても workflow_dispatch のトリガーは発火しない
上記のような secrets.GITHUB_TOKEN で動作しないケースでは代わりに Personal Access Token を使うと動作する

https://stackoverflow.com/questions/67550727/push-event-doesnt-trigger-workflow-on-push-paths-github-actions

https://github.com/slackapi/slack-github-action