Workflows

Get a high-level overview of GitHub Actions workflows, including triggers, syntax, and advanced features.

En este artículo

About workflows

Un flujo de trabajo es un proceso automatizado configurable que ejecutará uno o más trabajos. Los flujos de trabajo se definen mediante un archivo de YAML que se verifica en tu repositorio y se ejecutará cuando lo active un evento dentro de este o puede activarse manualmente o en una programación definida.

Los flujos de trabajo se definen en el directorio .github/workflows de un repositorio. Un repositorio puede tener varios flujos de trabajo, y cada uno puede realizar un conjunto diferente de tareas, como las siguientes:

  • Compilar y probar de solicitudes de incorporación de cambios
  • Implementar la aplicación cada vez que se crea una versión
  • Agregar una etiqueta cada vez que se abre una incidencia nueva

Workflow basics

A workflow must contain the following basic components:

  1. One or more events that will trigger the workflow.
  2. One or more jobs, each of which will execute on a runner machine and run a series of one or more steps.
  3. Each step can either run a script that you define or run an action, which is a reusable extension that can simplify your workflow.

For more information on these basic components, see Understanding GitHub Actions.

Diagram of an event triggering Runner 1 to run Job 1, which triggers Runner 2 to run Job 2. Each of the jobs is broken into multiple steps.

Workflow triggers

Los activadores de los flujos de trabajo son eventos que ocasionan que se ejecute un flujo de trabajo. Estos eventos pueden ser:

  • Eventos que ocurren en el repositorio de tu flujo de trabajo
  • Eventos que se producen fuera de GitHub y desencadenan un evento repository_dispatch en GitHub
  • Tiempos programados
  • Manual

Por ejemplo, puedes configurar tu flujo de trabajo para que se ejecute cuando se realiza una subida a la rama predeterminada de tu repositorio, cuando se crea un lanzamiento o cuando se abre una propuesta.

Los desencadenadores de flujos de trabajo se definen con la clave on. Para más información, consulta Sintaxis del flujo de trabajo para GitHub Actions.

Los siguientes pasos se producen para activar una ejecución de flujo de trabajo:

  1. Un eventto ocurre en tu repositorio. El evento tiene un SHA de confirmación asociado y una ref de Git.
  2. GitHub busca en el directorio .github/workflows de la raíz del repositorio los archivos de flujo de trabajo que están presentes en el SHA de confirmación asociado o en la referencia de Git del evento.
  3. Se desencadena una ejecución de flujos de trabajo para cualquier flujo de trabajo que tenga valores on: que coincidan con el evento desencadenador. Algunos eventos también requieren que el flujo de trabajo esté presente en la rama predeterminada del repositorio para poder ejecutarse.

Cada ejecución de flujo de trabajo utiliza la versión de este que esté presente en el SHA de confirmación asociado o Git Ref del evento. Cuando se ejecuta un flujo de trabajo, GitHub establece las variables de entorno GITHUB_SHA (SHA de confirmación) y GITHUB_REF (referencia de Git) en el entorno del ejecutor. Para más información, consulta Almacenamiento de información en variables.

For more information, see Activar un flujo de trabajo.

Next steps

To build your first workflow, see Creating an example workflow.