Note
Re-run workflows use the privileges of the actor who initially triggered the workflow, not the privileges of the actor who initiated the re-run. The workflow will also use the same GITHUB_SHA (commit SHA) and GITHUB_REF (git ref) of the original event that triggered the workflow run.
Re-running all the jobs in a workflow
-
On GitHub, navigate to the main page of the repository.
-
Under your repository name, click Actions.
-
In the left sidebar, click the workflow you want to see.
-
From the list of workflow runs, click the name of the run to see the workflow run summary.
-
In the upper-right corner of the workflow, re-run jobs.
- If any jobs failed, select the Re-run jobs dropdown menu and click Re-run all jobs.
- If no jobs failed, click Re-run all jobs.
-
Optionally, to enable runner diagnostic logging and step debug logging for the re-run, select Enable debug logging.
-
Click Re-run jobs.
-
To re-run a failed workflow run, use the
run rerunsubcommand, replacingRUN_IDwith the ID of the failed run that you want to re-run. If you don't specify arun-id, GitHub CLI returns an interactive menu for you to choose a recent failed run.Shell gh run rerun RUN_ID
gh run rerun RUN_IDTo enable runner diagnostic logging and step debug logging for the re-run, use the
--debugflag.Shell gh run rerun RUN_ID --debug
gh run rerun RUN_ID --debug -
To view the progress of the workflow run, use the
run watchsubcommand and select the run from the interactive list.Shell gh run watch
gh run watch
Re-running failed jobs in a workflow
-
On GitHub, navigate to the main page of the repository.
-
Under your repository name, click Actions.
-
In the left sidebar, click the workflow you want to see.
-
From the list of workflow runs, click the name of the run to see the workflow run summary.
-
In the upper-right corner of the workflow, select the Re-run jobs dropdown menu, and click Re-run failed jobs.
-
Optionally, to enable runner diagnostic logging and step debug logging for the re-run, select Enable debug logging.
-
Click Re-run jobs.
To re-run failed jobs in a workflow run, use the run rerun subcommand with the --failed flag. Replace RUN_ID with the ID of the run for which you want to re-run failed jobs. If you don't specify a run-id, GitHub CLI returns an interactive menu for you to choose a recent failed run.
gh run rerun RUN_ID --failed
To enable runner diagnostic logging and step debug logging for the re-run, use the --debug flag.
gh run rerun RUN_ID --failed --debug
Re-running a specific job in a workflow
-
On GitHub, navigate to the main page of the repository.
-
Under your repository name, click Actions.
-
In the left sidebar, click the workflow you want to see.
-
From the list of workflow runs, click the name of the run to see the workflow run summary.
-
Under the "Jobs" section of the left sidebar, next to the job that you want to re-run, click .
-
Optionally, to enable runner diagnostic logging and step debug logging for the re-run, select Enable debug logging.
-
Click Re-run jobs.
To re-run a specific job in a workflow run, use the run rerun subcommand with the --job flag. Replace JOB_ID with the ID of the job that you want to re-run.
gh run rerun --job JOB_ID
To enable runner diagnostic logging and step debug logging for the re-run, use the --debug flag.
gh run rerun --job JOB_ID --debug
Reviewing previous workflow runs
-
On GitHub, navigate to the main page of the repository.
-
Under your repository name, click Actions.
-
In the left sidebar, click the workflow you want to see.
-
From the list of workflow runs, click the name of the run to see the workflow run summary.
-
To the right of the run name, select the Latest dropdown menu and click a previous run attempt.