Skip to main content

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 sua execução inicial.

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 reexecução de um fluxo de trabalho ou trabalhos em um fluxo de trabalho usa o mesmo GITHUB_SHA (commit SHA) e GITHUB_REF (Git ref) do evento original que acionou a execução do fluxo de trabalho. O fluxo de trabalho usará os privilégios do criador que inicialmente acionou o fluxo de trabalho, não os privilégios do criador que iniciou a reexecução. Você pode re-executar um fluxo de trabalho ou trabalhos em um fluxo de trabalho por até 30 dias após a execução inicial. Você não pode re-executar trabalhos em um fluxo de trabalho uma vez que seus registros superaram seus limites de retenção. Para obter mais informações, consulte "Limites de uso, cobrança e administração." Quando você re-executar um fluxo de trabalho ou trabalhos em um fluxo de trabalho, você pode habilitar o registro de depuração para a re-execução. Isso permitirá o registro de diagnóstico do executor e o registro de depuração de etapas para a nova execução. Para obter mais informações sobre o registro de depuração, consulte "Habilitando o registro 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.

  2. Under your repository name, click Actions. Aba Ações na navegação principal do repositório

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

  4. From the list of workflow runs, click the name of the run to see the workflow run summary.

    Nome da execução do fluxo de trabalho

  5. No canto superior direito do fluxo de trabalho, use o menu suspenso Reexecutar trabalhos e selecione Reexecutar todos os trabalhos.

    Se nenhum trabalho falhar, você não verá o menu suspenso Reexecutar trabalhos. Em vez disso, clique em Reexecutar todos os trabalhos. Menu suspenso reexecutar

  1. Opcionalmente, para habilitar o log de diagnóstico do executor e a etapa de log de depuração para a reexecução, selecione Habilitar log de depuração. Habilitar log de depuração

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

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

gh run rerun run-id

Para habilitar habilitar o log de diagnóstico do executor e o log de depuração da etapa para a reexecução, use o sinalizador --debug.

gh run rerun run-id --debug

Para visualizar o progresso da execução do fluxo de trabalho, use o subcomando executar inspeção 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.

  2. Under your repository name, click Actions. Aba Ações na navegação principal do repositório

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

  4. From the list of workflow runs, click the name of the run to see the workflow run summary.

    Nome da execução do fluxo de trabalho

  5. No canto superior direito do fluxo de trabalho, use o menu suspenso Reexecutar trabalhos e selecione Reexecutar trabalhos com falhas. Menu suspenso de executar novamente trabalhos com falha

  6. Opcionalmente, para habilitar o log de diagnóstico do executor e a etapa de log de depuração para a reexecução, selecione Habilitar log de depuração. Habilitar log de depuração

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

gh run rerun run-id --failed

Para habilitar habilitar o log de diagnóstico do executor e o log de depuração da etapa para a reexecuçã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.

  2. Under your repository name, click Actions. Aba Ações na navegação principal do repositório

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

  4. From the list of workflow runs, click the name of the run to see the workflow run summary.

    Nome da execução do fluxo de trabalho

  5. Ao lado do trabalho que você deseja executar novamente, clique em . Reexecutar trabalho selecionado

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

  6. Opcionalmente, para habilitar o log de diagnóstico do executor e a etapa de log de depuração para a reexecução, selecione Habilitar log de depuração. Habilitar log de depuração

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

gh run rerun --job job-id

Para habilitar habilitar o log de diagnóstico do executor e o log de depuração da etapa para a reexecução, use o sinalizador --debug.

gh run rerun --job job-id --debug

Re-executar fluxos de trabalho e trabalhos com fluxos de trabalho reutilizáveis

Os fluxos de trabalho reutilizáveis de repositórios públicos podem ser referenciados usando um SHA, uma tag de versão ou um nome de branch. Para obter mais informações, consulte "Chamando um fluxo de trabalho reutilizável".

Ao executar novamente um fluxo de trabalho que usa um fluxo de trabalho reutilizável e a referência não é um SHA, existem alguns comportamentos que você deve conhecer:

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, consulte "Obter uma execução de workflow".

  1. No GitHub.com, navegue até a página principal do repositório.

  2. Under your repository name, click Actions. Aba Ações na navegação principal do repositório

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

  4. From the list of workflow runs, click the name of the run to see the workflow run summary.

    Nome da execução do fluxo de trabalho

  5. Quaisquer tentativas anteriores de execução são exibidas no menu suspenso mais recentes. Tentativas de execução anteriores

  6. Clique em uma entrada para visualizar os resultados.