Skip to main content

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.

Who can use this feature

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

Observação: no momento, não há suporte para os executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

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. You cannot re-run jobs in a workflow once its logs have passed their retention limits. For more information, see "Usage limits, billing, and administration."

Re-running all the jobs in a workflow

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.

  2. Abaixo do nome do repositório, clique em Actions. Guia Actions no menu de navegação do repositório principal

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções de fluxo de trabalho, clique no nome da execução para ver o resumo da execução do fluxo de trabalho.

    Nome da execução do fluxo de trabalho

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

    Rerun checks drop-down menu

Para saber mais sobre a GitHub CLI, confira "Sobre a 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_ID

To view the progress of the workflow run, use the run watch subcommand and select the run from the interactive list.

gh run watch

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

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.

  2. Abaixo do nome do repositório, clique em Actions. Guia Actions no menu de navegação do repositório principal

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções de fluxo de trabalho, clique no nome da execução para ver o resumo da execução do fluxo de trabalho.

    Nome da execução do fluxo de trabalho

  5. In the upper-right corner of the workflow, use the Re-run jobs drop-down menu, and select Re-run failed jobs.

    Rerun checks drop-down menu

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

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

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.

  2. Abaixo do nome do repositório, clique em Actions. Guia Actions no menu de navegação do repositório principal

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções de fluxo de trabalho, clique no nome da execução para ver o resumo da execução do fluxo de trabalho.

    Nome da execução do fluxo de trabalho

  5. Next to the job that you want to re-run, click . Re-run selected job

    Alternatively, click on a job to view the log. In the log, click . Re-run selected job

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

Re-running workflows and jobs with reusable workflows

Fluxos de trabalho reutilizáveis de repositórios públicos podem ser referenciados usando um SHA, uma tag de lançamento ou um nome de branch. Para ver mais informações, confira "Como chamar um fluxo de trabalho reutilizável".

Quando você executa novamente um fluxo de trabalho que usa um fluxo de trabalho reutilizável e a referência não é um SHA, há alguns comportamentos a serem observados:

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

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.

  2. Abaixo do nome do repositório, clique em Actions. Guia Actions no menu de navegação do repositório principal

  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda

  4. Na lista de execuções de fluxo de trabalho, clique no nome da execução para ver o resumo da execução do fluxo de trabalho.

    Nome da execução do fluxo de trabalho

  5. Any previous run attempts are shown in the Latest drop-down menu. Previous run attempts

  6. Click an entry to view its results.