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 obter mais informações 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
-
Em GitHub, acesse a página principal do repositório.
-
No nome do repositório, clique em Ações.
-
Na barra lateral esquerda, clique no nome do fluxo de trabalho que deseja executar.
-
Clique no botão Executar fluxo de trabalho, que fica acima da lista de execuções de fluxo de trabalho.
Note
Para você ver o botão Run workflow, o arquivo de fluxo de trabalho precisa usar o gatilho de evento
workflow_dispatch
. Somente os arquivos de fluxo de trabalho que usam o gatilho do eventoworkflow_dispatch
têm a opção de executar o fluxo de trabalho manualmente usando o botão Executar fluxo de trabalho. Para obter mais informações sobre a configuração do eventoworkflow_dispatch
, confira "Eventos que disparam fluxos de trabalho". -
Selecione o menu suspenso Branch e clique em um branch para executar o fluxo de trabalho.
-
Se o fluxo de trabalho exigir entradas, preencha os campos.
-
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.
Note
Você pode definir até 10 inputs
para um evento workflow_dispatch
.
Para obter mais informações sobre o uso da API REST, confira "Pontos de extremidade da API REST para fluxos de trabalho".