A GitHub Action that allows you to wait for another GitHub check until all are completed. This is useful if you want to run one Workflow only if another is not running.
steps:
- name: Wait for all builds to complete
uses: apptio-msobala/[email protected]
id: wait-for-build
with:
token: ${{ secrets.GITHUB_TOKEN }}
checkName: build
ref: ${{ github.event.pull_request.head.sha || github.sha }}
This Action accepts the following configuration parameters via with:
-
token
Required
The GitHub token to use for making API requests. Typically, this would be set to
${{ secrets.GITHUB_TOKEN }}
. -
checkName
Required
The name of the GitHub check to wait for. For example,
build
ordeploy
.IMPORTANT: If the check you're referencing is provided by another GitHub Actions workflow, make sure that you reference the name of a Job within that workflow, and not the name the Workflow itself.
-
ref
Default:
github.sha
The Git ref of the commit you want to poll for a passing check.
PROTIP: You may want to use
github.event.pull_request.head.sha
when working with Pull Requests.PROTIP2: You may want to use
refs/heads/{branch}
if you want to observe a particular branch. -
repo
Default:
github.repo.repo
The name of the Repository you want to poll for a passing check.
-
owner
Default:
github.repo.owner
The name of the Repository's owner you want to poll for a passing check.
-
timeoutSeconds
Default:
600
The number of seconds to wait for the check to complete. If the check does not complete within this amount of time, this Action will emit a
conclusion
value oftimed_out
. -
intervalSeconds
Default:
10
The number of seconds to wait before each poll of the GitHub API for checks on this commit.
This action fails if any error occurred or timeout was reached.