About re-running workflows and jobs
Re-running a workflow or jobs in a workflow uses the same GITHUB_SHA (commit SHA) and GITHUB_REF (Git ref) of the original event that triggered the workflow run. You can re-run a workflow or jobs in a workflow for up to 30 days after the initial run.
Re-running all the jobs in a workflow
-
On GitHub.com, 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 you want to see.
-
In the upper-right corner of the workflow, use the Re-run jobs drop-down menu, and select Re-run all jobs.
If no jobs failed, you will not see the Re-run jobs drop-down menu. Instead, click Re-run all jobs.
To learn more about GitHub CLI, see "About GitHub CLI."
To re-run a failed workflow run, use the run rerun subcommand. Replace run-id with the ID of the failed run that you want to re-run. 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-idTo view the progress of the workflow run, use the run watch subcommand and select the run from the interactive list.
gh run watchRe-running failed jobs in a workflow
If any jobs in a workflow run failed, you can re-run just the jobs that failed. When you re-run failed jobs in a workflow, a new workflow run will start for all failed jobs and their dependents. Any outputs for any successful jobs in the previous workflow run will be used for the re-run. Any artifacts that were created in the initial run will be available in the re-run. Any environment protection rules that passed in the previous run will automatically pass in the re-run.
- On GitHub.com, 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 you want to see.
- In the upper-right corner of the workflow, use the Re-run jobs drop-down menu, and select Re-run failed 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 --failedRe-running a specific job in a workflow
When you re-run a specific job in a workflow, a new workflow run will start for the job and any dependents. Any outputs for any other jobs in the previous workflow run will be used for the re-run. Any artifacts that were created in the initial run will be available in the re-run. Any environment protection rules that passed in the previous run will automatically pass in the re-run.
-
On GitHub.com, 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 you want to see.
-
Next to the job that you want to re-run, click .
Alternatively, click on a job to view the log. In the log, click .
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-idReviewing previous workflow runs
You can view the results from your previous attempts at running a workflow. You can also view previous workflow runs using the API. For more information, see "Get a workflow run".
- On GitHub.com, 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 you want to see.
- Any previous run attempts are shown in the Latest drop-down menu.
- Click an entry to view its results.
