Skip to content
Latchkey

O Que É um Workflow Run no GitHub Actions?

Um workflow run é uma execução de um workflow. Cada execução tem seus próprios logs, status, ID e número de tentativa.

Toda vez que um evento dispara um workflow, o GitHub cria um workflow run: uma instância concreta que você pode acompanhar, inspecionar e reexecutar. É o objeto que você vê listado na aba Actions.

O que é

Um workflow run é uma única invocação de um workflow. Ele agrupa os jobs que executaram, seus logs e status, e metadados como o evento que disparou e o commit.

Como funciona

Quando um gatilho dispara, o GitHub registra uma execução com um run_id único, agenda seus jobs em runners e atualiza o status da execução para sucesso, falha ou cancelado conforme os jobs terminam.

Run context values
steps:
  - run: echo "Run ${{ github.run_id }} attempt ${{ github.run_attempt }}"

Reexecuções e tentativas

Você pode reexecutar uma execução que falhou, o que incrementa run_attempt. Isso é útil para repetir falhas transitórias sem fazer push de um novo commit.

Por que importa

O workflow run é sua unidade de auditoria e depuração: ele mostra exatamente o que executou, em qual commit, com qual resultado. Run IDs permitem que ferramentas e os runners gerenciados da Latchkey correlacionem jobs com eventos de infraestrutura.

Conceitos relacionados

Uma execução contém jobs e é produzida por um gatilho; seus metadados são expostos pelo contexto github.

Principais conclusões

  • Um workflow run é uma execução de um workflow.
  • Ele tem um run_id único e um run_attempt.
  • Reexecutar uma execução incrementa o número da tentativa.

Guias relacionados