Skip to main content

Executar um fluxo de trabalho manualmente

Quando um fluxo de trabalho é configurado para ser executado no evento workflow_dispatch, você pode executar o fluxo de trabalho usando a guia Ações no GitHub, a GitHub CLI ou a API REST.

Tool navigation

Note

No momento, não há suporte para executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

Configurar um fluxo de trabalho para ser executado manualmente

Para executar um fluxo de trabalho manualmente, o fluxo de trabalho precisa ser configurado para ser executado no evento workflow_dispatch.

Para disparar o evento workflow_dispatch, seu fluxo de trabalho precisa estar no branch padrão. Para saber mais sobre a configuração do evento workflow_dispatch, confira Eventos que disparam fluxos de trabalho.

É necessário o acesso de gravação ao repositório é para executar essas etapas.

Executando um fluxo de trabalho

Note

Para saber mais sobre GitHub CLI, confira Sobre o a CLI do GitHub.

Para executar um fluxo de trabalho, use o subcomando workflow run. Substitua o parâmetro workflow pelo nome, pela ID ou pelo nome do arquivo de fluxo de trabalho que deseja executar. Por exemplo, "Link Checker", 1234567 ou "link-check-test.yml". Se você não especificar um fluxo de trabalho, GitHub CLI irá retornar um menu interativo para você escolher um fluxo de trabalho.

gh workflow run WORKFLOW

Se o fluxo de trabalho aceitar entradas, GitHub CLI solicitará que você os insira. Como alternativa, você pode usar -f ou -F para adicionar uma entrada no formato key=value. Use -F para fazer a leitura de um arquivo.

gh workflow run greet.yml -f name=mona -f greeting=hello -F data=@myfile.txt

Você também pode passar as entradas como JSON usando a entrada padrão.

echo '{"name":"mona", "greeting":"hello"}' | gh workflow run greet.yml --json

Para executar um fluxo de trabalho em um branch que não seja o branch padrão do repositório, use o sinalizador --ref.

gh workflow run WORKFLOW --ref BRANCH

Para ver o progresso da execução do fluxo de trabalho, use o subcomando run watch e selecione a execução na lista interativa.

gh run watch

Executar um fluxo de trabalho usando a API REST

Ao usar a API REST, você configura os parâmetros do corpo da solicitação inputs e ref. Se as entradas forem omitidas, serão usados os valores-padrão definidos no arquivo de fluxo de trabalho.

Note

Você pode definir até 10 inputs para um evento workflow_dispatch.

Para saber mais sobre o uso da API REST, confira Pontos de extremidade da API REST para fluxos de trabalho.