Skip to content
zap

GitHub Action

rerun-actions

v0.3.0 Latest version

rerun-actions

zap

rerun-actions

Rerun other GitHub Actions on pull requests via comment commands

Installation

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

              

- name: rerun-actions

uses: estroz/rerun-actions@v0.3.0

Learn more about this action in estroz/rerun-actions

Choose a version

rerun-actions

A GitHub Action that re-runs other Action Workflows via PR comment commands.

How it works

Once a PR is submitted against a repo with GitHub Actions enabled, a workflow will run. If that workflow fails, it can be rerun by POST-ing to the Actions API. rerun-actions reruns workflows by parsing the body of a PR comment (specified by the comment's id retrieved from an issue_comment webhook event) for certain commands and rerunning jobs matching those commands.

Some notes:

  • The PR either must have an ok-to-test label present on the PR, or the user who writes a command must be an organization member, or repo owner, contributor, or collaborator.
    • Typically ok-to-test can/should only be applied by repo reviewers/approvers to prevent spam and abuse.
  • rerun-actions should only be run on comment creation. See the below examples for how to do this.

Comment commands

The following commands are supported by this action:

  • /rerun-all - rerun all failed workflows.
  • /rerun-workflow <workflow name> - rerun a specific failed workflow. Only one workflow name can be specified. Multiple /rerun-workflow commands are allowed per comment.

Note: Only failed workflows can be rerun due to limitations in the Github Actions API.

Examples

Example workflow file (use this config verbatim):

on:
  issue_comment:
    types: [created]

jobs:
  rerun_pr_tests:
    name: rerun_pr_tests
    if: ${{ github.event.issue.pull_request }}
    runs-on: ubuntu-20.04
    steps:
    - uses: estroz/rerun-actions@main
      with:
        repo_token: ${{ secrets.GITHUB_TOKEN }}
        comment_id: ${{ github.event.comment.id }}