{"meta":{"title":"Executar um fluxo de trabalho manualmente","intro":"Quando um fluxo de trabalho é configurado para ser executado no workflow_dispatch evento, você pode executar o fluxo de trabalho usando a guia GitHubGitHub CLIAções, ou a API REST.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/enterprise-cloud@latest/actions","title":"GitHub Actions"},{"href":"/pt/enterprise-cloud@latest/actions/how-tos","title":"Instruções"},{"href":"/pt/enterprise-cloud@latest/actions/how-tos/manage-workflow-runs","title":"Gerenciar execuções de fluxos de trabalho"},{"href":"/pt/enterprise-cloud@latest/actions/how-tos/manage-workflow-runs/manually-run-a-workflow","title":"Executar um fluxo de trabalho manualmente"}],"documentType":"article"},"body":"# Executar um fluxo de trabalho manualmente\n\nQuando um fluxo de trabalho é configurado para ser executado no workflow_dispatch evento, você pode executar o fluxo de trabalho usando a guia GitHubGitHub CLIAções, ou a API REST.\n\n## Configurar um fluxo de trabalho para ser executado manualmente\n\nPara executar um fluxo de trabalho manualmente, o fluxo de trabalho precisa ser configurado para ser executado no evento `workflow_dispatch`.\n\nPara disparar o evento `workflow_dispatch`, seu fluxo de trabalho precisa estar no branch padrão. Para saber mais sobre a configuração do evento `workflow_dispatch`, confira [Eventos que disparam fluxos de trabalho](/pt/enterprise-cloud@latest/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).\n\nÉ necessário o acesso de gravação ao repositório é para executar essas etapas.\n\n## Executando um fluxo de trabalho\n\n\n\n\n\n> \\[!NOTE]\n> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/enterprise-cloud@latest/github-cli/github-cli/about-github-cli).\n\nPara 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 retornará um menu interativo para escolher um fluxo de trabalho.\n\n```shell\ngh workflow run WORKFLOW\n```\n\nSe o fluxo de trabalho aceitar entradas, GitHub CLI solicitará que você as 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.\n\n```shell\ngh workflow run greet.yml -f name=mona -f greeting=hello -F data=@myfile.txt\n```\n\nVocê também pode passar as entradas como JSON usando a entrada padrão.\n\n```shell\necho '{\"name\":\"mona\", \"greeting\":\"hello\"}' | gh workflow run greet.yml --json\n```\n\nPara executar um fluxo de trabalho em um branch que não seja o branch padrão do repositório, use o sinalizador `--ref`.\n\n```shell\ngh workflow run WORKFLOW --ref BRANCH\n```\n\nPara ver o progresso da execução do fluxo de trabalho, use o subcomando `run watch` e selecione a execução na lista interativa.\n\n```shell\ngh run watch\n```\n\n
\n\n## Executar um fluxo de trabalho usando a API REST\n\nAo 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.\n\n> \\[!NOTE]\n> Você pode definir até 25 `inputs`para um `workflow_dispatch` evento.\n\nPara saber mais sobre o uso da API REST, confira [Endpoints da API REST para fluxos de trabalho](/pt/enterprise-cloud@latest/rest/actions/workflows#create-a-workflow-dispatch-event)."}