Eventos que desencadenan flujos de trabajo
Puedes configurar tus flujos de trabajo para que se ejecuten cuando ocurre una actividad específica en GitHub, en un horario programado o cuando se produce un evento fuera de GitHub.
GitHub Actions is available with GitHub Free, GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub One. GitHub Actions is not available for private repositories owned by accounts using legacy per-repository plans. For more information, see "GitHub's products."
Acerca de los eventos de flujo de trabajo
Puedes configurar tu flujo de trabajo para que se ejecute cuando se creen eventos de webhook a partir de una actividad en GitHub. Los flujos de trabajo pueden usar más de un evento de webhook para desencadenar la ejecución de un flujo de trabajo. Para obtener más información, consulta "Webhooks" en la documentación del programador de GitHub. Para obtener más información sobre la sintaxis on, consulta "Sintaxis de flujo de trabajo para GitHub Actions".
The following steps occur to trigger a workflow run:
-
An event occurs on your repository, and the resulting event webhook has an associated commit SHA and Git ref.
-
The
.github/workflowsdirectory in your repository is searched for workflow files at the associated commit SHA or Git ref. The workflow files must be present in that commit SHA or Git ref to be considered.For example, if the event occurred on a particular repository branch, then the workflow files must be present in the repository on that branch.
-
The workflow files for that commit SHA and Git ref are inspected, and a new workflow run is triggered for any workflows that have
on:values that match the triggering event.The workflow runs on your repository's code at the same commit SHA and Git ref that triggered the event. When a workflow runs, GitHub sets the
GITHUB_SHA(commit SHA) andGITHUB_REF(Git ref) environment variables in the runner environment. For more information, see "Using environment variables."
Note: You cannot trigger new workflow runs using the GITHUB_TOKEN. For more information, see "Triggering new workflows using a personal access token."
Ejemplo con un solo evento
# Activa al subir
on: push
Ejemplo con una lista de eventos
# Activa el flujo de trabajo en la solicitud de inserción o extracción
on: [push, pull_request]
Example using multiple events with activity types or configuration
If you need to specify activity types or configuration for an event, you must configure each event separately. You must append a colon (:) to all events, including events without configuration.
on:
# Trigger the workflow on push or pull request,
# but only for the master branch
push:
branches:
- master
pull_request:
branches:
- master
# Also trigger on page_build, as well as release created events
page_build:
release:
types: # This configuration does not affect the page_build event above
- created
Eventos de webhook
Puedes configurar tu flujo de trabajo para que se ejecute cuando se crean eventos de webhook en GitHub. Algunos eventos tienen más de un tipo de actividad que activa el evento. Si más de un tipo de actividad activa el evento, puedes especificar qué tipos de actividad activarán el flujo de trabajo para que se ejecute.
Comprobar evento de ejecución: check_run
Ejecuta tu flujo de trabajo en cualquier momento que se produzca el evento check_run. Más de un tipo de actividad desencadena este evento. Para obtener información sobre la REST API, consulta "Comprobar ejecucionesruns" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
check_run | - creado- resolicitado- completado- requested_action | Última confirmación en la rama por defecto | Rama por defecto |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando una comprobación de ejecución ha sido resolicitada o requested_action.
on:
check_run:
types: [rerequested, requested_action]
Comprobar evento de ejecución: check_suite
Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento check_suite. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la REST API, consulta "Comprobar ejecuciones" in la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
Note: To prevent recursive workflows, this event does not trigger workflows if the check suite was created by GitHub Actions.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
check_suite | - completado- solicitado- resolicitado | Última confirmación en la rama por defecto | Rama por defecto |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando una comprobación de ejecución ha sido resolicitada o completada.
on:
check_suite:
types: [rerequested, completed]
Crear evento: create
Ejecuta tu flujo de trabajo en cualquier momento en que alguien cree una rama o etiqueta, que activa el evento crear. Para obtener más información sobre la API REST, consulta "Crear una referencia" en la documentación del programador de GitHub.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
create (crear) | n/a | Última confirmación en la rama o etiqueta creada | Rama o etiqueta creada |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento crear.
on:
create
Eliminar evento: delete
Ejecuta tu flujo de trabajo en cualquier momento en que alguien cree una rama o etiqueta, que activa el evento eliminar. Para obtener más información sobre la API REST, consulta "Eliminar una referencia" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
delete (eliminar) | n/a | Última confirmación en la rama por defecto | Rama por defecto |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento eliminar.
on:
delete
Evento de implementación: implementación
Ejecuta tu flujo de trabajo en cualquier momento en que alguien cree una implementación, que activa el evento implementación. Deployments created with a commit SHA may not have a Git ref. Para obtener más información sobre la API REST, consulta "Implementaciones" in la documentación del programador de GitHub.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
deployment | n/a | Confirmación de implementación | Rama o etiqueta que se debe implementar (vacío si está confirmada) |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento implementación.
on:
deployment
Evento de estado de implementación: deployment_status
Ejecuta tu flujo de trabajo en cualquier momento en que un tercero proporcione un estado de implementación, que activa un evento de deployment_status. Deployments created with a commit SHA may not have a Git ref. Para obtener más información sobre la API REST, consulta "Crear un estado de implementación" en la documentación del programador de GitHub.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
deployment_status | n/a | Confirmación de implementación | Rama o etiqueta que se debe implementar (vacío si está confirmada) |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento implementación.
on:
deployment_status
Evento de Fork: fork
Ejecuta tu flujo de trabajo en cualquier momento en que alguien bifurque un repositorio, lo que activa el evento de bifurcación. Para obtener más información sobre la API REST, consulta "Crear una bifurcación" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
bifurcación | n/a | Última confirmación en la rama por defecto | Rama por defecto |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento de bifurcación.
on:
fork
Evento Gollum: gollum
Ejecuta tu flujo de trabajo en cualquier momento en que alguien cree o actualice una página Wiki, que activa el evento gollum.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
gollum | n/a | Última confirmación en la rama por defecto | Rama por defecto |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento gollum.
on:
gollum
Evento de comentario de propuesta: issue_comment
Ejecuta tu flujo de trabajo en cualquier momento que se produzca el evento issue_comment. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Comentarios de propuestas" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
comentario_propuesta | - created- edited- deleted | Última confirmación en la rama por defecto | Rama por defecto |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un miembro ha sido creado o eliminado.
on:
issue_comment:
types: [created, deleted]
Evento de incidencias: propuestas
Ejecuta tu flujo de trabajo en cualquier momento que se produzca el evento de propuestas. Más de un tipo de actividad desencadena este evento. Para obtener información sobre la API REST, consulta "Propuestas" in la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
propuestas | - opened- edited- deleted- transferred- pinned- unpinned- closed- reopened- assigned- unassigned- labeled- unlabeled- locked- unlocked- milestoned- demilestoned | Última confirmación en la rama predeterminada | Rama predeterminada |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando una propuesta ha sido abierta, editada, o marcada como hito.
on:
issues:
types: [opened, edited, milestoned]
Etiquetar evento: etiqueta
Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento de etiquetado. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Etiquetas" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
etiqueta | - created- edited- deleted | Última confirmación en la rama por defecto | Rama por defecto |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un miembro ha sido creado o eliminado.
on:
label:
types: [created, deleted]
Evento de hito: milestone
Ejecuta tu flujo de trabajo en cualquier momento que se produzca el evento de hito. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la REST API, consulta "Hitos" in la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
hito | - created- closed- opened- edited- deleted | Última confirmación en la rama por defecto | Rama por defecto |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
For example, you can run a workflow when a milestone has been opened or deleted.
on:
milestone:
types: [opened, deleted]
Evento de compilación de página: page_build
Ejecuta tu flujo de trabajo en cualquier momento en que alguien suba a una GitHub Rama habilitada para páginas, que activa el evento page_build. Para obtener más información sobre la API REST, consulta "Páginas" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
page_build | n/a | Última confirmación en la rama por defecto | n/a |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento page_build.
on:
page_build
Evento de proyección: project
Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento de project. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Projects" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
project | - created- updated- closed- reopened- edited- deleted | Última confirmación en la rama por defecto | Rama por defecto |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un proyecto ha sido creado o eliminado.
on:
project:
types: [created, deleted]
Evento de proyección de tarjeta: project_card
Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento project_card. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Tarjetas de proyecto" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
project_card | - created- moved- converted to an issue- edited- deleted | Última confirmación en la rama por defecto | Rama por defecto |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un proyecto ha sido abierto o eliminado.
on:
project_card:
types: [opened, deleted]
Evento de proyección de columna: project_column
Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento project_column. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Columnas de proyecto" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
project_column | - created- updated- moved- deleted | Última confirmación en la rama por defecto | Rama por defecto |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando una columna de proyecto ha sido creado o eliminado.
on:
project_column:
types: [created, deleted]
Evento público: public
Ejecuta tu flujo de trabajo en cualquier momento en que alguien haga público un repositorio privado, que activa el evento público. Para obtener más información sobre la API REST, consulta "Editar repositorios" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
public | n/a | Última confirmación en la rama por defecto | Rama por defecto |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento público.
on:
public
Evento de solicitud de extracción: pull_request
Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento de pull_request. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Solicitudes de extraccións" en la documentación del programador de GitHub.
Nota: Por defecto, un flujo de trabajo solo se ejecuta cuando un tipo de actividad pull_request está abierto, sincronizado, o reabierto. Para activar los flujos de trabajo para más tipos de actividades, usa la palabra clave tipos.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
pull_request | - assigned- unassigned- labeled- unlabeled- opened- edited- closed- reopened- synchronize- ready_for_review- locked- unlocked - review_requested - review_request_removed | Última confirmación de fusión en la rama GITHUB_REF | Rama de fusión de PR refs/pull/:prNumber/merge |
Puedes extender o limitar los tipos de actividad por defecto usando la palabra clave types. Para obtener más información, consulta "Sintaxis del flujo de trabajo paraGitHub Actions".
For example, you can run a workflow when a pull request has been assigned, opened, synchronize, or reopened.
on:
pull_request:
types: [assigned, opened, synchronize, reopened]
Eventos de solicitud de extracción para repositorios bifurcados
Nota: los flujos de trabajo no se ejecutan en repositorios base privados cuando abres una solicitud de extracción desde un repositorio bifurcado.
Cuando creas una solicitud de extracción desde un repositorio bifurcado al repositorio base, GitHub envía el evento pull_request al repositorio base y no se producen eventos de solicitud de extracción en el repositorio bifurcado.
Los flujos de trabajo no se ejecutan en repositorios bifurcados por defecto. Debes habilitar las Acciones de GitHub en la pestaña Actions (Acciones) del repositorio bifurcado.
Los permisos para el GITHUB_TOKEN en los repositorios bifurcados son de solo lectura. Para más información, consulta "Autenticando con el GITHUB_TOKEN."
Evento de revisión de solicitud de extracción: pull_request_review
Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento pull_request_review. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Revisión de solicitud de extracción" en la documentación del programador de GitHub.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
pull_request_review | - submitted- edited- dismissed | Última confirmación de fusión en la rama GITHUB_REF | Rama de fusión de PR refs/pull/:prNumber/merge |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando una revisión de solicitud de extracción ha sido editada o descartada.
on:
pull_request_review:
types: [edited, dismissed]
Eventos de solicitud de extracción para repositorios bifurcados
Nota: los flujos de trabajo no se ejecutan en repositorios base privados cuando abres una solicitud de extracción desde un repositorio bifurcado.
Cuando creas una solicitud de extracción desde un repositorio bifurcado al repositorio base, GitHub envía el evento pull_request al repositorio base y no se producen eventos de solicitud de extracción en el repositorio bifurcado.
Los flujos de trabajo no se ejecutan en repositorios bifurcados por defecto. Debes habilitar las Acciones de GitHub en la pestaña Actions (Acciones) del repositorio bifurcado.
Los permisos para el GITHUB_TOKEN en los repositorios bifurcados son de solo lectura. Para más información, consulta "Autenticando con el GITHUB_TOKEN."
Evento de comentario de revisión de solicitud de extracción: pull_request_review_comment
Ejecuta tu flujo de trabajo en cualquier momento en que se modifique una diferencia unificada de solicitud de extracción, que activa el evento pull_request_review_comment. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta Revisar comentarios en la documentación del programador de GitHub.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
pull_request_review_comment | - created- edited- deleted | Última confirmación de fusión en la rama de GITHUB_REF | Rama de fusión de PR refs/pull/:prNumber/merge |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un comentario de revisión de solicitud de extracción ha sido creado o eliminado.
on:
pull_request_review_comment:
types: [created, deleted]
Eventos de solicitud de extracción para repositorios bifurcados
Nota: los flujos de trabajo no se ejecutan en repositorios base privados cuando abres una solicitud de extracción desde un repositorio bifurcado.
Cuando creas una solicitud de extracción desde un repositorio bifurcado al repositorio base, GitHub envía el evento pull_request al repositorio base y no se producen eventos de solicitud de extracción en el repositorio bifurcado.
Los flujos de trabajo no se ejecutan en repositorios bifurcados por defecto. Debes habilitar las Acciones de GitHub en la pestaña Actions (Acciones) del repositorio bifurcado.
Los permisos para el GITHUB_TOKEN en los repositorios bifurcados son de solo lectura. Para más información, consulta "Autenticando con el GITHUB_TOKEN."
Evento de subida: push
Nota: La carga disponible del webhook para las Acciones de GitHub no incluye los atributos añadidos, eliminados, y modificados en el objeto de confirmación. Puedes recuperar el objeto de confirmación completo usando la API REST. Para obtener más información, consulta "Obtener una sola confirmación" en la documentación del programador de GitHub".
Ejecuta tu flujo de trabajo cuando alguien sube una rama a tu repositorio, lo que activa el evento push.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
subir | n/a | Confirmación subida, a menos que se elimine una rama (cuando se trata de la rama por defecto) | Ref actualizado |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento push.
on:
push
Registry package event: registry_package
Runs your workflow anytime a package is published or updated. For more information, see "Managing packages with GitHub Packages."
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
registry_package | - published- updated | Commit of the published package | Branch or tag of the published package |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
For example, you can run a workflow when a package has been published.
on:
registry_package:
types: [published]
Evento de lanzamiento: release
Nota: El evento release no se activa para lanzamientos draft.
Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento de lanzamiento. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Lanzamientos" en la documentación del programador de GitHub.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
lanzamiento | - published, - unpublished - created - edited - deleted - prereleased | Última confirmación en el lanzamiento etiquetado | Etiqueta de lanzamiento |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando un lanzamiento ha sido publicado.
on:
release:
types: [published]
Evento de estado: estado
Ejecuta tu flujo de trabajo en cualquier momento en que alguien cree una rama o etiqueta, que activa el evento crear. Para obtener más información sobre la API REST, consulta "Estados" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
estado | n/a | Última confirmación en la rama por defecto | n/a |
Por ejemplo, puedes ejecutar un flujo de trabajo cuando se produzca el evento de estado.
on:
status
Evento de observación: ver
Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento ver. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Marcar con estrella" en la documentación del programador de GitHub.
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
ver | - comenzado | Última confirmación en la rama por defecto | Rama por defecto |
Por defecto, todos los tipos de actividad desencadenan un flujo de trabajo a ejecutarse. Puedes limitar tus ejecuciones de flujo de trabajo a tipos de actividad específicos usando la palabra clave Tipos. Para obtener más información, consulta "Sintaxis del flujo de trabajo para GitHub Actions".
Por ejemplo, puedes ejecutar un flujo de trabajo cuando alguien coloca una estrella en un repositorio, que es el tipo de actividad comenzado que activa el evento Ver.
on:
watch:
types: [started]
Eventos programados: schedule
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
| n/a | n/a | Última confirmación en la rama por defecto | Rama por defecto |
Puedes programar un flujo de trabajo para que se ejecute en horarios UTC específicos usando sintaxis de cron POSIX. Los flujos de trabajo programados se ejecutan en la confirmación más reciente en la rama base o en la rama por defecto. The shortest interval you can run scheduled workflows is once every 5 minutes.
This example triggers the workflow every 15 minutes:
on:
schedule:
# * is a special character in YAML so you have to quote this string
- cron: '*/15 * * * *'
La sintaxis de cron tiene cinco campos separados por un espacio, y cada campo representa una unidad de tiempo.
┌───────────── minuto (0 - 59)
│ ┌───────────── hora (0 - 23)
│ │ ┌───────────── día del mes (1 - 31)
│ │ │ ┌───────────── mes (1 - 12 o EN-DIC)
│ │ │ │ ┌───────────── día de la semana (0 - 6 o DOM-SÁB)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
* * * * *
Puedes usar estos operadores en cualquiera de los cinco campos:
| Operador | Descripción | Ejemplo |
|---|---|---|
| * | Cualquier valor | * * * * * se ejecuta todos los días a cada minuto. |
| , | Separador de la lista de valores | 2,10 4,5 * * * se ejecuta en el minuto 2 y 10 de la cuarta y quinta hora de cada día. |
| - | Rango de valores | 0 4-6 * * * se ejecuta en el minuto 0 de la cuarta, quinta y sexta hora. |
| / | Valores del paso | 20/15 * * * * se ejecuta cada 15 minutos a partir del minuto 20 hasta el minuto 59 (minutos 20, 35 y 50). |
Nota: GitHub Actions no es compatible con la sintaxis que no es estándar @yearly, @monthly, @weekly, @daily, @hourly y @reboot.
Puedes usar contrab guru para generar tu sintaxis de cron y confirmar a qué hora se ejecutará. Para que puedas comenzar, hay también una lista de ejemplos de crontab guru.
Eventos externos: repository_dispatch
| Carga del evento Webhook | Tipos de actividad | GITHUB_SHA | GITHUB_REF |
|---|---|---|---|
| repository_dispatch | n/a | Última confirmacion en la rama de GITHUB_REF | Rama que recibió el envío |
Note: This event will only trigger a workflow run if the workflow file is on the master or default branch.
Puedes usar la API GitHub para activar un evento de webhook denonimado repository_dispatch cuando desees activar un flujo de trabajo para la actividad que sucede fuera de GitHub. Para obtener más información, consulta "Crear un evento de despacho de repositorio" en la documentación del programador de GitHub.
Para desencadenar el evento de webhook repository_dispatch personalizado, debes enviar una solicitud de POST a un punto final de una API de GitHub y dar un nombre de event_type para describir el tipo de actividad. Para desencadenar la ejecución de un flujo de trabajo, también debes configurar tu flujo de trabajo para usar el evento repository_dispatch.
Ejemplo
Este evento no tiene tipos de actividad adicionales por lo que no es compatible con la palabra clave tipos palabra clave.
on: repository_dispatch
Triggering new workflows using a personal access token
When you use the repository's GITHUB_TOKEN to perform tasks on behalf of the GitHub Actions app, events triggered by the GITHUB_TOKEN will not create a new workflow run. This prevents you from accidentally creating recursive workflow runs. For example, if a workflow run pushes code using the repository's GITHUB_TOKEN, a new workflow will not run even when the repository contains a workflow configured to run when push events occur. For more information, see "Authenticating with the GITHUB_TOKEN."
If you would like to trigger a workflow from a workflow run, you can trigger the event using a personal access token. You'll need to create a personal access token and store it as a secret in your repository. To minimize your GitHub Actions usage costs, ensure that you don't create recursive or unintended workflow runs. For more information, see "Creating and storing encrypted secrets."

