Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.
All products
GitHub Actions

Executar um fluxo de trabalho manualmente

Neste artigo

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.

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 obter mais informações sobre o 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

  1. No GitHub.com, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Actions. Guia Actions no menu de navegação do repositório principal

  2. Na barra lateral esquerda, clique no nome do fluxo de trabalho que deseja executar.

    Captura de tela da página "Ações". Na barra lateral esquerda, o nome do fluxo de trabalho está realçado com um contorno em laranja escuro.

  3. Acima da lista de execuções de fluxo de trabalho, selecione Executar fluxo de trabalho.

    Captura de tela da página de fluxo de trabalho. Acima da lista de execuções de fluxo de trabalho, o botão rotulado como "Executar fluxo de trabalho", está contornado em laranja escuro.

  4. Selecione o menu suspenso Branch e clique em um branch para executar o fluxo de trabalho.

  5. Se o fluxo de trabalho exigir entradas, preencha os campos.

  6. Clique em Executar fluxo de trabalho.

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.

Nota: você pode definir até 10 inputs para um evento workflow_dispatch.

Para obter mais informações sobre o uso da API REST, confira "Ações".