Re-running workflows and jobs

You can re-run a workflow run, all failed jobs in a workflow run, or specific jobs in a workflow run up to 30 days after its initial run.

Wer kann dieses Feature verwenden?

People with write permissions to a repository can re-run workflows in the repository.

Tool navigation

In diesem Artikel

Hinweis

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

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Namen deines Repositorys auf Aktionen.

    Screenshot: Registerkarten für das Repository „github/docs“. Die Registerkarte „Aktionen“ ist mit einem orangefarbenen Rahmen hervorgehoben.

  3. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst.

    Screenshot der linken Randleiste der Registerkarte „Aktionen“. Ein Workflow, „CodeQL“, ist dunkelorange umrandet.

  4. Klicke in der Liste der Workflowausführungen auf den Namen der Ausführung, um die Zusammenfassung der Workflowausführung anzuzeigen.

  5. 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.

  6. Um optional die Runnerdiagnoseprotokollierung und die schrittweise Debugprotokollierung für die erneute Ausführung zu aktivieren, wähle Debugprotokollierung aktivieren aus.

  7. Klicke auf Aufträge erneut ausführen.

  1. To re-run a failed workflow run, use the run rerun subcommand, replacing 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.

    Shell
    gh run rerun RUN_ID

    Verwende zum Aktivieren der Runnerdiagnoseprotokollierung und schrittweisen Debugprotokollierung für die erneute Ausführung das --debug-Flag.

    Shell
    gh run rerun RUN_ID --debug

  2. 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

Re-running failed jobs in a workflow

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Namen deines Repositorys auf Aktionen.

    Screenshot: Registerkarten für das Repository „github/docs“. Die Registerkarte „Aktionen“ ist mit einem orangefarbenen Rahmen hervorgehoben.

  3. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst.

    Screenshot der linken Randleiste der Registerkarte „Aktionen“. Ein Workflow, „CodeQL“, ist dunkelorange umrandet.

  4. Klicke in der Liste der Workflowausführungen auf den Namen der Ausführung, um die Zusammenfassung der Workflowausführung anzuzeigen.

  5. In the upper-right corner of the workflow, select the Re-run jobs dropdown menu, and click Re-run failed jobs.

  6. Um optional die Runnerdiagnoseprotokollierung und die schrittweise Debugprotokollierung für die erneute Ausführung zu aktivieren, wähle Debugprotokollierung aktivieren aus.

  7. Klicke auf Aufträge erneut ausführen.

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

Verwende zum Aktivieren der Runnerdiagnoseprotokollierung und schrittweisen Debugprotokollierung für die erneute Ausführung das --debug-Flag.

gh run rerun RUN_ID --failed --debug

Re-running a specific job in a workflow

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Namen deines Repositorys auf Aktionen.

    Screenshot: Registerkarten für das Repository „github/docs“. Die Registerkarte „Aktionen“ ist mit einem orangefarbenen Rahmen hervorgehoben.

  3. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst.

    Screenshot der linken Randleiste der Registerkarte „Aktionen“. Ein Workflow, „CodeQL“, ist dunkelorange umrandet.

  4. Klicke in der Liste der Workflowausführungen auf den Namen der Ausführung, um die Zusammenfassung der Workflowausführung anzuzeigen.

  5. Under the "Jobs" section of the left sidebar, next to the job that you want to re-run, click .

  6. Um optional die Runnerdiagnoseprotokollierung und die schrittweise Debugprotokollierung für die erneute Ausführung zu aktivieren, wähle Debugprotokollierung aktivieren aus.

  7. Klicke auf Aufträge erneut ausführen.

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

Verwende zum Aktivieren der Runnerdiagnoseprotokollierung und schrittweisen Debugprotokollierung für die erneute Ausführung das --debug-Flag.

gh run rerun --job JOB_ID --debug

Reviewing previous workflow runs

  1. Navigieren Sie auf GitHub zur Hauptseite des Repositorys.

  2. Klicke unter dem Namen deines Repositorys auf Aktionen.

    Screenshot: Registerkarten für das Repository „github/docs“. Die Registerkarte „Aktionen“ ist mit einem orangefarbenen Rahmen hervorgehoben.

  3. Klicke in der linken Seitenleiste auf den Workflow, den Du sehen willst.

    Screenshot der linken Randleiste der Registerkarte „Aktionen“. Ein Workflow, „CodeQL“, ist dunkelorange umrandet.

  4. Klicke in der Liste der Workflowausführungen auf den Namen der Ausführung, um die Zusammenfassung der Workflowausführung anzuzeigen.

  5. To the right of the run name, select the Latest dropdown menu and click a previous run attempt.