Skip to content
activity

GitHub Action

Workflow run cleanup action

v0.3.3 Latest version

Workflow run cleanup action

activity

Workflow run cleanup action

Cancel previous runs of a workflow

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Workflow run cleanup action

uses: rokroskar/[email protected]

Learn more about this action in rokroskar/workflow-run-cleanup-action

Choose a version

Conventional Commits

DEPRECATION WARNING

GitHub Action supports the functionality of this action natively with the concurrency command.

Please check out the release artice and the official docs:

Workflow run cleanup action

This action cleans up previously running instances of a workflow on the same branch. This accomplishes the task of automatically cancelling CI runs on pushes to the same branch, which is a common feature in most CI systems but currently not possible with GitHub actions.

Configuration

  • DEBUG: if set to TRUE the debug logs will be printed.

  • The action uses the GitHub action environment variables to obtain the workflow name and branch. You must, however, set the GITHUB_TOKEN environment variable:

Note: if you use a personal access token, ensure that the repo scope is included.

Example usage

uses: rokroskar/workflow-run-cleanup-action
env:
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  DEBUG: FALSE

You may want to disable this action from running on tags or master, especially if you have CD pipelines linked to your CI passing on every commit. In that case, something like this should work:

name: CI
on:
  push: []
  jobs:
    cleanup-runs:
      runs-on: ubuntu-latest
      steps:
      - uses: rokroskar/workflow-run-cleanup-action@master
        env:
          GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
      if: "!startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/master'"
    ...
    other-jobs: