Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Executar um fluxo de trabalho manualmente

In this article

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 fluxo de trabalho que deseja executar.

    Fluxo de trabalho selecionado de ações

  3. Acima da lista de execuções de fluxo de trabalho, selecione Executar fluxo de trabalho. expedição do fluxo de trabalho das ações

  4. Use o menu suspenso Branch para selecionar o branch do fluxo de trabalho e digite os parâmetros de entrada. Clique em Executar fluxo de trabalho. fluxo de trabalho da execução manual das ações

Para saber mais sobre a GitHub CLI, confira "Sobre a GitHub CLI".

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 como usar a API REST, confira "Criar um evento de expedição de fluxo de trabalho".