jprdonnelly/docs
1
0
Fork 0
mirror of synced 2025-12-30 12:02:01 -05:00
Code Issues Projects Releases Wiki Activity

Reviewing previous workflow runs (#21489)

Browse Source 
Co-authored-by: Chris Patterson <chrispat@github.com>
Co-authored-by: Jacob Wallraff <thyeggman@github.com>
This commit is contained in:
Martin Lopes
2021-10-08 16:02:00 +10:00
committed by GitHub
parent a32a8e3fa0
commit c28ae8b91b
4 changed files with 73 additions and 46 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
assets/images/help/settings/actions-review-workflow-rerun.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 49 KiB

2
content/actions/managing-workflow-runs/index.md
View File

@@ -14,7 +14,7 @@ versions:
ghae: '*'
children:
- /manually-running-a-workflow
- /re-running-a-workflow
- /re-running-workflows-and-jobs
- /canceling-a-workflow
- /approving-workflow-runs-from-public-forks
- /reviewing-deployments

45
content/actions/managing-workflow-runs/re-running-a-workflow.md
View File

@@ -1,45 +0,0 @@
---
title: Re-running a workflow
intro: You can re-run an instance of a workflow up to 30 days after the initial run.
product: '{% data reusables.gated-features.actions %}'
permissions: People with write permissions to a repository can re-run workflows in the repository.
versions:
fpt: '*'
ghes: '*'
ghae: '*'
---
{% data reusables.actions.enterprise-beta %}
{% data reusables.actions.enterprise-github-hosted-runners %}
Re-running 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 up to 30 days after the initial run.
{% include tool-switcher %}
{% webui %}
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.actions-tab %}
{% data reusables.repositories.navigate-to-workflow %}
{% data reusables.repositories.view-run %}
1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run all jobs**.{% ifversion fpt or ghes > 3.0 or ghae %}![Re-run checks drop-down menu](/assets/images/help/repository/rerun-checks-drop-down-updated.png){% else %}![Re-run checks drop-down menu](/assets/images/help/repository/rerun-checks-drop-down.png){% endif %}
{% endwebui %}
{% cli %}
{% data reusables.cli.cli-learn-more %}
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`, {% data variables.product.prodname_cli %} returns an interactive menu for you to choose a recent failed run.
```shell
gh run rerun <em>run-id</em>
```
To view the progress of the workflow run, use the `run watch` subcommand and select the run from the interactive list.
```shell
gh run watch
```
{% endcli %}

72
content/actions/managing-workflow-runs/re-running-workflows-and-jobs.md Normal file
View File

@@ -0,0 +1,72 @@
---
title: Re-running workflows and jobs
intro: You can re-run a workflow run up to 30 days after its initial run.
product: '{% data reusables.gated-features.actions %}'
permissions: People with write permissions to a repository can re-run workflows in the repository.
miniTocMaxHeadingLevel: 3
redirect_from:
- /actions/managing-workflow-runs/re-running-a-workflow
versions:
fpt: '*'
ghes: '*'
ghae: '*'
---
{% data reusables.actions.enterprise-beta %}
{% data reusables.actions.enterprise-github-hosted-runners %}
## Re-running all the jobs in a workflow
Re-running 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 for up to 30 days after the initial run.
{% include tool-switcher %}
{% webui %}
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.actions-tab %}
{% data reusables.repositories.navigate-to-workflow %}
{% data reusables.repositories.view-run %}
{% ifversion fpt or ghes > 3.2 or ghae-issue-4721 %}
1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run all jobs**
![Rerun checks drop-down menu](/assets/images/help/repository/rerun-checks-drop-down.png)
{% endif %}
{% ifversion ghes < 3.3 or ghae %}
1. In the upper-right corner of the workflow, use the **Re-run jobs** drop-down menu, and select **Re-run all jobs**.
![Re-run checks drop-down menu](/assets/images/help/repository/rerun-checks-drop-down-updated.png)
{% endif %}
{% endwebui %}
{% cli %}
{% data reusables.cli.cli-learn-more %}
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`, {% data variables.product.prodname_cli %} returns an interactive menu for you to choose a recent failed run.
```shell
gh run rerun <em>run-id</em>
```
To view the progress of the workflow run, use the `run watch` subcommand and select the run from the interactive list.
```shell
gh run watch
```
{% endcli %}
{% ifversion fpt or ghes > 3.2 or ghae-issue-4721 %}
### Reviewing 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"](/rest/reference/actions#get-a-workflow-run).
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.actions-tab %}
{% data reusables.repositories.navigate-to-workflow %}
{% data reusables.repositories.view-run %}
1. Any previous run attempts are shown in the left pane.
![Rerun workflow](/assets/images/help/settings/actions-review-workflow-rerun.png)
1. Click an entry to view its results.
{% endif %}