O Que É um Arquivo de Workflow do GitHub Actions?

Um workflow é a unidade de nível mais alto no GitHub Actions: um arquivo YAML que mapeia eventos para os jobs que devem rodar.

Tudo no GitHub Actions começa com um workflow. É um arquivo de configuração que diz "quando isso acontecer, execute estes jobs." Um repositório pode ter muitos workflows, cada um com um propósito diferente.

O que é

Um workflow é um arquivo YAML armazenado em .github/workflows/. Ele tem um nome, um conjunto de eventos de disparo sob on: e um bloco jobs: descrevendo o trabalho a ser realizado.

Como funciona

Quando um evento corresponde aos filtros on: do workflow, o GitHub cria um workflow run. A execução agenda cada job em um runner e acompanha o sucesso ou a falha geral.

name: Build and Test
on:
  push:
    branches: [main]
  pull_request:
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: make build

Um repositório, muitos workflows

Você normalmente separa as responsabilidades em arquivos distintos: um para testes, um para linting, um para deployment. Cada um roda de forma independente e reporta seu próprio status check.

Por que isso importa

Workflows são o contrato entre os eventos do repositório e a automação. Mantê-los pequenos e focados os torna mais fáceis de ler, depurar e reutilizar.

Conceitos relacionados

Um workflow contém jobs, que contêm steps. Ele é acionado por eventos e produz um workflow run que você pode inspecionar na aba Actions.

Principais conclusões

• Um workflow é um arquivo YAML em .github/workflows/.
• Ele vincula eventos (on:) a jobs.
• Um repositório pode conter muitos workflows independentes.

Guias relacionados