This is a GitHub Action that will cancel any previous runs that are not completed
for a given workflow.
This includes runs with a status of queued
or in_progress
.
When you git push
, this GitHub Action will capture the current Branch and SHA. It will query GitHub's API to find previous workflow runs that match the Branch but do not match the SHA. These in-progress runs will be cancelled leaving only this run.
Read more about the Workflow Runs API.
Typically, you will want to add this action as the first step in a workflow so it can cancel itself on the next push.
jobs:
test:
runs-on: ubuntu-latest
steps:
- name: Cancel Previous Runs
uses: styfle/cancel-workflow-action@0.5.0
with:
access_token: ${{ github.token }}
#- name: Run Tests
# uses: actions/setup-node@v1
# run: node test.js
# ... etc
In some cases, you may wish to avoid modifying all your workflows and instead create a new workflow that cancels your other workflows. This can be useful when you have a problem with workflows getting queued.
- Visit
https://api.github.com/repos/:org/:repo/actions/workflows
to find the Workflow ID(s) you wish to automaticaly cancel. - Add a new file
.github/workflows/cancel.yml
with the following:
name: Cancel
on: [push]
jobs:
cancel:
name: 'Cancel Previous Runs'
runs-on: ubuntu-latest
timeout-minutes: 3
steps:
- uses: styfle/cancel-workflow-action@0.5.0
with:
workflow_id: 479426
access_token: ${{ github.token }}
Note: workflow_id
accepts a comma separated list of IDs.
Because this action can only cancel workflows if it is actually being run, it only helps if the pipeline isn't saturated and there are still runners available to schedule the workflow.
By default, this action does not cancel any workflows older than itself. The optional flag all_but_latest
switches to a mode where the action also cancels itself and all later-scheduled workflows but the last one.
name: Cancel
on: [push]
jobs:
cancel:
name: 'Cancel Previous Runs'
runs-on: ubuntu-latest
timeout-minutes: 3
steps:
- uses: styfle/cancel-workflow-action@0.5.0
with:
all_but_latest: true
access_token: ${{ github.token }}
At the time of writing 0.5.0
is the latest release but you can select any release.
- Clone this repo
- Run
yarn install
- Edit
./src/index.ts
- Run
yarn build
- Commit changes including
./dist/index.js
bundle