O Que É um Step no GitHub Actions?

Um step é a menor unidade executável no GitHub Actions. Cada um roda um comando ou chama uma action.

Jobs são listas de steps. Steps executam em ordem no mesmo runner, e cada um pode rodar um comando de shell ou invocar uma action empacotada. É assim que você de fato realiza o trabalho.

O que é

Um step é um item na lista steps: de um job. Os dois tipos são run: (um comando de shell) e uses: (uma referência a uma action).

steps:
  - uses: actions/checkout@v4
  - name: Install and test
    run: |
      npm ci
      npm test

Como funciona

Steps rodam sequencialmente. Como compartilham o filesystem do runner, steps anteriores preparam o estado (clonar o repositório, instalar dependências) do qual steps posteriores dependem.

Nomeação e condições

Dê aos steps um name: para logs legíveis. Você pode rodar um step condicionalmente com if: e referenciar seus resultados em outro lugar se ele produzir outputs.

Por que isso importa

Steps são onde ficam os comandos reais de build, test e deploy. Mantê-los pequenos e bem nomeados torna as falhas fáceis de localizar no log.

Conceitos relacionados

Steps vivem dentro de jobs, podem chamar actions via uses: e podem produzir step outputs consumidos por steps posteriores.

Principais conclusões

• Um step é uma tarefa: um comando run: ou uma action uses:.
• Steps rodam em ordem e compartilham o filesystem do runner.
• Nomeie steps para logs legíveis e condicione-os com if:.

Guias relacionados