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
-
No GitHub.com, navegue até a página principal do repositório.
-
Under your repository name, click Actions.
-
Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.
-
From the list of workflow runs, click the name of the run to see the workflow run summary.
-
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.
- 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.
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.
-
No GitHub.com, navegue até a página principal do repositório.
-
Under your repository name, click Actions.
-
Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.
-
From the list of workflow runs, click the name of the run to see the workflow run summary.
-
No canto superior direito do fluxo de trabalho, use o menu suspenso Reexecutar trabalhos e selecione Reexecutar trabalhos com falhas.
-
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.
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.
-
No GitHub.com, navegue até a página principal do repositório.
-
Under your repository name, click Actions.
-
Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.
-
From the list of workflow runs, click the name of the run to see the workflow run summary.
-
Ao lado do trabalho que você deseja executar novamente, clique em .
Alternativamente, clique em um trabalho para visualizar o registro. No registro, clique em .
-
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.
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:
- Executar novamente todos os trabalhos em um fluxo de trabalho irá usar o fluxo de trabalho reutilizável da referência especificada. Para obter mais informações sobre a reexecução de todos os trabalhos em um fluxo de trabalho, consulte "Executar novamente todos os trabalhos em um fluxo de trabalho".
- Reexecutar os trabalhos que falharam ou um trabalho específico em um fluxo de trabalho usará o fluxo de trabalho reutilizável do mesmo commit SHA da primeira tentativa. Para obter mais informações sobre a reexecução de trabalhos que falharam em um fluxo de trabalho, consulte "Reexecutar trabalhos que falharam em fluxo de trabalho". Para obter mais informações sobre a reexecução de um trabalho específico em um fluxo de trabalho, consulte "Reexecutar um trabalho específico em um fluxo de trabalho".
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".
-
No GitHub.com, navegue até a página principal do repositório.
-
Under your repository name, click Actions.
-
Na barra lateral esquerda, clique no fluxo de trabalho que deseja ver.
-
From the list of workflow runs, click the name of the run to see the workflow run summary.
-
Quaisquer tentativas anteriores de execução são exibidas no menu suspenso mais recentes.
-
Clique em uma entrada para visualizar os resultados.