Ejecutar un flujo de trabajo manualmente

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

Tool navigation

En este artículo

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 obtener más información sobre la configuración del evento workflow_dispatch, consulta "Eventos que desencadenan flujos de trabajo".

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

Ejecutar un flujo de trabajo

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

  2. En el nombre del repositorio, haz clic en Acciones.

    Captura de pantalla de las pestañas del repositorio "github/docs". La pestaña "Proyectos" aparece resaltada con un contorno naranja.

  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.

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

    Nota: Para ver el botón Ejecutar flujo de trabajo, el archivo del flujo de trabajo debes 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 obtener más información sobre la configuración del evento workflow_dispatch, consulta "Eventos que desencadenan flujos de trabajo".

    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.

  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.

Para más información sobre GitHub CLI, consulta "Acerca del CLI de GitHub".

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 especificas un flujo de trabajo, GitHub CLI devolverá un menú interactivo para que elijas un flujo de trabajo.

gh workflow run WORKFLOW

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

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.

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.

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.

gh run watch

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.

Nota: Puedes definir hasta 10 inputs para un evento workflow_dispatch.

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