# Executar um fluxo de trabalho manualmente

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.

> \[!NOTE]
> No momento, não há suporte para executores hospedados no GitHub Enterprise Server no GitHub.

## 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 saber mais sobre a configuração do evento `workflow_dispatch`, confira [Eventos que disparam fluxos de trabalho](/pt/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).

É necessário o acesso de gravação ao repositório é para executar essas etapas.

## Executando um fluxo de trabalho

<div class="ghd-tool webui">

1. Em GitHub, acesse a página principal do repositório.

2. No nome do repositório, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-play" aria-label="play" role="img"><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"></path></svg> Actions**.

   ![Captura de tela das guias do repositório "github/docs". A guia "Ações" está realçada com um contorno laranja.](/assets/images/help/repository/actions-tab-global-nav-update.png)

3. Na barra lateral esquerda, clique no nome do fluxo de trabalho que deseja executar.

   ![Captura de tela da página "Ações". Na barra lateral esquerda, o nome do fluxo de trabalho está realçado com um contorno em laranja escuro.](/assets/images/help/repository/actions-select-workflow-2022.png)

4. Clique no botão **Executar fluxo de trabalho**, que fica acima da lista de execuções de fluxo de trabalho.

   > \[!NOTE]
   > Para você ver o botão **Run workflow**, o arquivo de fluxo de trabalho precisa usar o gatilho de evento `workflow_dispatch`. Somente os arquivos de fluxo de trabalho que usam o gatilho do evento `workflow_dispatch` têm a opção de executar o fluxo de trabalho manualmente usando o botão **Executar fluxo de trabalho**. Para saber mais sobre a configuração do evento `workflow_dispatch`, confira [Eventos que disparam fluxos de trabalho](/pt/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).

   ![Captura de tela da página de fluxo de trabalho. Acima da lista de execuções de fluxo de trabalho, o botão rotulado como "Executar fluxo de trabalho" está delineado em laranja escuro.](/assets/images/help/actions/actions-workflow-dispatch.png)

5. Selecione o menu suspenso **Branch** e clique em um branch para executar o fluxo de trabalho.

6. Se o fluxo de trabalho exigir entradas, preencha os campos.

7. Clique em **Executar fluxo de trabalho**.

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/enterprise-server@3.22/github-cli/github-cli/about-github-cli).

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 retornará um menu interativo para escolher um fluxo de trabalho.

```shell
gh workflow run WORKFLOW
```

Se 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.

```shell
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.

```shell
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`.

```shell
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.

```shell
gh run watch
```

</div>

## 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.

> \[!NOTE]
> Você pode definir até 10`inputs`para um `workflow_dispatch` evento.

Para saber mais sobre o uso da API REST, confira [Endpoints da API REST para fluxos de trabalho](/pt/enterprise-server@3.22/rest/actions/workflows#create-a-workflow-dispatch-event).