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 workflowSe 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.txtVocê também pode passar as entradas como JSON usando a entrada padrão.
echo '{"name":"mona", "greeting":"hello"}' | gh workflow run greet.yml --jsonPara 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-namePara 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 watchExecutar 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".