O Que É workflow_call no GitHub Actions?

workflow_call é o gatilho que torna um workflow chamável por outros workflows, transformando-o em um workflow reutilizável.

Um workflow reutilizável precisa anunciar que pode ser chamado. O evento workflow_call faz exatamente isso, definindo os inputs e secrets que o workflow aceita quando outro workflow o invoca.

O que é

Um gatilho declarado sob on: que expõe o workflow para invocação por outros. Ele define o contrato: quais inputs e secrets os chamadores devem ou podem fornecer.

on:
  workflow_call:
    inputs:
      env:
        required: true
        type: string
    secrets:
      token:
        required: true

Como funciona

Um chamador referencia o workflow no uses: de um job, passando with: para inputs e secrets:. O GitHub executa os jobs do chamado como parte da execução do chamador, respeitando o contrato declarado.

Inputs e secrets

Os inputs são tipados e podem ser obrigatórios ou opcionais com valores padrão. Os secrets precisam ser passados explicitamente (ou herdados com secrets: inherit); o chamado não pode ler silenciosamente os secrets do chamador.

Por que importa

workflow_call é a base dos workflows reutilizáveis, permitindo que equipes centralizem e versionem a lógica de CI compartilhada em vez de copiá-la em cada repositório.

Conceitos relacionados

É o que torna um workflow reutilizável reutilizável e é distinto de workflow_dispatch, que serve para execuções manuais.

Principais conclusões

• workflow_call torna um workflow chamável por outros.
• Ele define inputs tipados e secrets obrigatórios.
• É a base dos workflows reutilizáveis.

Guias relacionados