Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Reexecutando fluxos de trabalho e trabalhos

Você pode executar novamente um fluxo de trabalho, todos os trabalhos que falharam na execução de um fluxo de trabalho ou trabalhos específicos em uma execução de fluxo de trabalho até 30 dias após a execução inicial.

Who can use this feature

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

Sobre a reexecução de fluxos de trabalho e trabalhos

A nova execução de um fluxo de trabalho ou de trabalhos em um fluxo de trabalho usa o mesmo GITHUB_SHA (SHA do commit) e a mesma GITHUB_REF (referência do Git) do evento original que disparou a execução de fluxo de trabalho. O fluxo de trabalho usará os privilégios do ator que inicialmente disparou o fluxo de trabalho, não os privilégios do ator que iniciou a execução novamente. Você pode executar novamente um fluxo de trabalho ou trabalhos em um fluxo de trabalho até 30 dias após a execução inicial. Você não poderá executar novamente trabalhos em um fluxo de trabalho depois que os logs ultrapassarem os limites de retenção. Para obter mais informações, confira "Limites de uso, cobrança e administração". Ao executar novamente um fluxo de trabalho ou os trabalhos em um fluxo de trabalho, você pode habilitar o log de depuração para a nova execução. Isso habilitará o log de diagnóstico do executor e o log de depuração de etapas para a execução nova. Para obter mais informações sobre o log de depuração, confira "Como habilitar o log de depuração".

Reexecutar todos os trabalhos em um fluxo de trabalho

  1. No GitHub.com, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Actions. Guia Actions no menu de navegação do repositório principal 1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda 1. 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 1. No canto superior direito do fluxo de trabalho, use o menu suspenso Executar trabalhos novamente e selecione Executar todos os trabalhos novamente.

    Se nenhum trabalho falhar, o menu suspenso Executar trabalhos novamente não será exibido. Em vez disso, clique em Executar todos os trabalhos novamente.

    Menu suspenso “Executar verificações novamente”

  2. Opcionalmente, para habilitar o log de diagnóstico do executor e o log de depuração de etapas para a nova execução, selecione Habilitar o log de depuração. Habilitar o log de depuração

Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

Para executar novamente uma execução de fluxo de trabalho com falha, use o subcomando run rerun. Substitua run-id pela ID da execução com falha que deseja executar novamente. Se você não especificar uma run-id, a GitHub CLI retornará um menu interativo para você escolher uma execução recente com falha.

gh run rerun RUN_ID

Para habilitar o log de diagnóstico do executor e o log de depuração de etapas para a nova execução, use o sinalizador --debug.

gh run rerun RUN_ID --debug

Para ver o progresso da execução do fluxo de trabalho, use o subcomando run watch e selecione a execução na lista interativa.

gh run watch

Reexecutar trabalhos que falharam em um fluxo de trabalho

Se qualquer trabalho na execução de um fluxo de trabalho falhar, você poderá executar novamente apenas os trabalhos que falharam. Ao reexecutar trabalhos que falharam em fluxo de trabalho, uma nova execução do fluxo de trabalho será iniciada para todos os trabalhos que falharam e seus dependentes. Todas as saídas para quaisquer trabalhos bem-sucedidos na execução anterior do fluxo de trabalho serão usadas para a nova execução. Todos os artefatos criados na execução inicial estarão disponíveis na reexecução. Todas as regras de proteção de ambiente que passaram na execução anterior serão automaticamente passadas na reexecução.

  1. No GitHub.com, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Actions. Guia Actions no menu de navegação do repositório principal 1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda 1. 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

  2. No canto superior direito do fluxo de trabalho, use o menu suspenso Executar trabalhos novamente e selecione Executar trabalhos com falha novamente.

    Menu suspenso “Executar verificações novamente”

  3. Opcionalmente, para habilitar o log de diagnóstico do executor e o log de depuração de etapas para a nova execução, selecione Habilitar o log de depuração. Habilitar o log de depuração

Para executar os trabalhos com falha novamente em uma execução de fluxo de trabalho, use o subcomando run rerun com o sinalizador --failed. Substitua run-id pela ID da execução para a qual deseja executar novamente os trabalhos com falha. Se você não especificar uma run-id, a GitHub CLI retornará um menu interativo para você escolher uma execução recente com falha.

gh run rerun RUN_ID --failed

Para habilitar o log de diagnóstico do executor e o log de depuração de etapas para a nova execução, use o sinalizador --debug.

gh run rerun RUN_ID --failed --debug

Reexecutando um trabalho específico em um fluxo de trabalho

Ao executar novamente um trabalho específico em um fluxo de trabalho, uma nova execução do fluxo de trabalho será iniciada para o trabalho e para quaisquer dependentes. Todas as saídas para outros trabalhos na execução anterior do fluxo de trabalho serão usadas para a nova execução. Todos os artefatos criados na execução inicial estarão disponíveis na reexecução. Todas as regras de proteção de ambiente que passaram na execução anterior serão automaticamente passadas na reexecução.

  1. No GitHub.com, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Actions. Guia Actions no menu de navegação do repositório principal 1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda 1. 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

  2. Ao lado do trabalho que você deseja executar novamente, clique em . Nova execução do trabalho selecionado

    Alternativamente, clique em um trabalho para visualizar o registro. No registro, clique em . Executar novamente o trabalho selecionado

  3. Opcionalmente, para habilitar o log de diagnóstico do executor e o log de depuração de etapas para a nova execução, selecione Habilitar o log de depuração. Habilitar o log de depuração

Para executar novamente um trabalho específico em uma execução de fluxo de trabalho, use o subcomando run rerun com o sinalizador --job. Substitua job-id pela ID do trabalho que deseja executar novamente.

gh run rerun --job JOB_ID

Para habilitar o log de diagnóstico do executor e o log de depuração de etapas para a nova execução, use o sinalizador --debug.

gh run rerun --job JOB_ID --debug

Executar novamente fluxos de trabalho e trabalhos com fluxos de trabalho reutilizáveis

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:

Revisando execuções de workflows anteriores

Você pode ver os resultados de suas tentativas anteriores de executar um fluxo de trabalho. Você também pode visualizar execuções de workflows anteriores do fluxo de trabalho usando a API. Para obter mais informações, confira "Obter uma execução de fluxo de trabalho".

  1. No GitHub.com, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Actions. Guia Actions no menu de navegação do repositório principal 1. Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver. Lista de fluxo de trabalho na barra lateral esquerda 1. 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

  2. Todas as tentativas de execução anteriores são mostradas no menu suspenso Mais recente. Tentativas de execução anteriores

  3. Clique em uma entrada para visualizar os resultados.