Configurar um fluxo de trabalho para ser executado manualmente
Para executar um fluxo de trabalho manualmente, o fluxo de trabalho deve ser configurado para ser executado no evento workflow_dispatch
. Para acionar o evento workflow_dispatch
, seu fluxo de trabalho deve estar no branch padrão. Para obter mais informações sobre a configuração do evento workflow_despatch
, consulte "Eventos que acionam 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.
- Under your repository name, click Actions.
- Na barra lateral esquerda, clique no fluxo de trabalho que deseja executar.
- Acima da lista de execuções de fluxo de trabalho, selecione Executarde fluxo de trabalho .
- Use o menu suspenso Branch para selecionar o branch do fluxo de trabalho e digite os parâmetros de entrada. Clique em Executarde fluxo de trabalho .
Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."
Para executar um fluxo de trabalho, use o subcomando execução do fluxo de trabalho
. Substitua o parâmetro fluxo de trabalho
Pelo nome, ID ou nome do arquivo do fluxo de trabalho que você deseja executar. Por exemplo, "Verificador de Link"
, 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 ler 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-name
Para visualizar o progresso da execução do fluxo de trabalho, use o subcomando executar inspeção
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 as entradas
e ref
como parâmetros do texto da solicitação. 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 entradas
para um evento de workflow_dispatch
.
Para obter mais informações sobre o uso da API REST, consulte o "Criar um evento de envio de fluxo de trabalho".