# Ejecutar un flujo de trabajo manualmente

Cuando se configura un flujo de trabajo para ejecutarse en el workflow_dispatch evento, puede ejecutar el flujo de trabajo mediante la pestaña Acciones de GitHub, GitHub CLIo la API REST.

> \[!NOTE]
> Actualmente los ejecutores hospedados por GitHub Enterprise Server no se admiten en GitHub.

## Configurar un flujo de trabajo para que se ejecute manualmente

Para ejecutar manualmente un flujo de trabajo, el flujo de trabajo debe configurarse para que se ejecute en el evento `workflow_dispatch`.

Para desencadenar el evento `workflow_dispatch`, el flujo de trabajo debe estar en la rama predeterminada. Para más información sobre la configuración del evento `workflow_dispatch`, consulta [Eventos que desencadenan flujos de trabajo](/es/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).

Se requiere tener acceso de escritura en el repositorio para llevar a cabo estos pasos.

## Ejecutar un flujo de trabajo

<div class="ghd-tool webui">

1. En GitHub, navegue hasta la página principal del repositorio.

2. En el nombre del repositorio, haz clic en **<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 pantalla de las pestañas del repositorio "github/docs". La pestaña "Proyectos" aparece resaltada con un contorno naranja.](/assets/images/help/repository/actions-tab-global-nav-update.png)

3. En la barra lateral izquierda, haz clic en el nombre del flujo de trabajo que quieres ejecutar.

   ![Captura de pantalla de la página "Acciones". En la barra lateral izquierda, se resalta un nombre de flujo de trabajo con un contorno en naranja oscuro.](/assets/images/help/repository/actions-select-workflow-2022.png)

4. Encima de la lista de ejecuciones de flujo de trabajo, haz clic en **Ejecutar flujo de trabajo**.

   > \[!NOTE]
   > Para ver el botón **Run workflow**, el archivo de flujo de trabajo debe usar el desencadenador de eventos `workflow_dispatch`. Solo los archivos de flujo de trabajo que usan el desencadenador de eventos de `workflow_dispatch` tendrán la opción de ejecutar el flujo de trabajo manualmente mediante el botón **Ejecutar flujo de trabajo**. Para más información sobre la configuración del evento `workflow_dispatch`, consulta [Eventos que desencadenan flujos de trabajo](/es/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#workflow_dispatch).

   ![Captura de pantalla de una página de flujo de trabajo. Sobre la lista de ejecuciones de flujo de trabajo, un botón, con la etiqueta "Ejecutar flujo de trabajo", se destaca en naranja oscuro.](/assets/images/help/actions/actions-workflow-dispatch.png)

5. Selecciona el menú desplegable **Rama** y haz clic en una rama para ejecutar el flujo de trabajo.

6. Si el flujo de trabajo requiere información, rellena los campos.

7. Haz clic en **Ejecutar flujo de trabajo**.

</div>

<div class="ghd-tool cli">

> \[!NOTE]
> Para más información sobre GitHub CLI, consulta [Acerca de GitHub CLI](/es/enterprise-server@3.22/github-cli/github-cli/about-github-cli).

Para ejecutar un flujo de trabajo, usa el subcomando `workflow run`. Reemplaza el parámetro `workflow` por el nombre, el id. o el nombre de archivo del flujo de trabajo que quieres ejecutar. Por ejemplo, `"Link Checker"`, `1234567` o `"link-check-test.yml"`. Si no especifica un flujo de trabajo, GitHub CLI devuelve un menú interactivo para que elija un flujo de trabajo.

```shell
gh workflow run WORKFLOW
```

Si el flujo de trabajo acepta entradas, GitHub CLI se le pedirá que las escriba. Como alternativa, puedes usar `-f` o `-F` para agregar una entrada en formato `key=value`. Usa `-F` para leer desde un archivo.

```shell
gh workflow run greet.yml -f name=mona -f greeting=hello -F data=@myfile.txt
```

También puedes pasar las entradas como JSON utilizando una entrada estándar.

```shell
echo '{"name":"mona", "greeting":"hello"}' | gh workflow run greet.yml --json
```

Para ejecutar un flujo de trabajo en una rama diferente de la rama predeterminada del repositorio, usa la marca `--ref`.

```shell
gh workflow run WORKFLOW --ref BRANCH
```

Para ver el progreso de la ejecución del flujo de trabajo, usa el subcomando `run watch` y selecciona la ejecución en la lista interactiva.

```shell
gh run watch
```

</div>

## Ejecutar un flujo de trabajo utilizando la API de REST

Cuando se usa la API de REST, se configura `inputs` y `ref` como parámetros del cuerpo de la solicitud. Si omites las entradas, se utilizarán los valores predeterminados que se hayan definido en el flujo de trabajo.

> \[!NOTE]
> Puede definir hasta 10`inputs`para un `workflow_dispatch` evento.

Para obtener más información sobre el uso la API de REST, consulta [Puntos de conexión de API de REST para flujos de trabajo](/es/enterprise-server@3.22/rest/actions/workflows#create-a-workflow-dispatch-event).