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
-
No GitHub.com, navegue até a página principal do repositório. 1. Abaixo do nome do repositório, clique em Actions.
-
Na barra lateral esquerda, clique no nome do fluxo de trabalho que deseja executar.
-
Acima da lista de execuções de fluxo de trabalho, selecione Executar fluxo 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.
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".