Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.
O GitHub AE está atualmente sob versão limitada. Entre em contato com nossa Equipe de Vendas para saber mais.

Executando manualmente um fluxo de trabalho

Quando um fluxo de trabalho é configurado para ser executado no evento workflow_dispatch, você pode executar o fluxo de trabalho usando a aba de Ações em GitHub, 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 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

  1. No your enterprise, navegue até a página principal do repositório.
  2. Under your repository name, click Actions. Aba Ações na navegação principal do repositório
  3. Na barra lateral esquerda, clique no fluxo de trabalho que deseja executar. ações selecionam fluxo de trabalho
  4. Acima da lista de execuções de fluxo de trabalho, selecione Executarde fluxo de trabalho . expedição de fluxo de trabalho ações
  5. 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 . ações executar manualmente 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".