Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

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.

Acciones de GitHub is available with GitHub gratis, GitHub Pro, Equipo de GitHub, and Nube de GitHub Enterprise. Acciones de GitHub is unavailable for per-repository plans, which are legacy billing plans. For more information, see "GitHub's products."

En este artículo

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 Acciones de GitHub".

Una acción en una ejecución de un flujo de trabajo no puede desencadenar una nueva ejecución de un flujo de trabajo. Por ejemplo, si una acción sube código usando el GITHUB_TOKEN del repositorio, no se ejecutará un nuevo flujo de trabajo aun cuando el repositorio contenga un flujo de trabajo configurado para ejecutarse cuando se produzcan eventos push.

Un flujo de trabajo se ejecuta en una versión específica de código en tu repositorio, determinada por el SHA de confirmación y el Git ref. GitHub determina el SHA de confirmación y el Git ref que desencadenó el evento usando la carga del evento de webhook. Cuando se ejecuta un flujo de trabajo, GitHub establece el GITHUB_SHA (SHA de confirmación) y las variables del entorno GITHUB_REF (Git ref) en el entorno virtual. Para obtener más información, consulta "Variables del entorno".

Ejemplo con un solo evento

on: push

Ejemplo con más de un evento

# Use an array when using more than one event
on: [push, pull_request]

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.

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 Acciones de GitHub".

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.

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 Acciones de GitHub".

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.

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. Las implementaciones creadas con SHA de confirmación pueden no tener un 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. Las implementaciones creadas con SHA de confirmación pueden no tener un 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.

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.

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.

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 Acciones de GitHub".

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.

Carga del evento Webhook Tipos de actividad GITHUB_SHA GITHUB_REF
problemas -opened
- edited
- deleted
- transferred
- pinned
- unpinned
- closed
- reopened
- assigned
- unassigned
- labeled
- unlabeled
- locked
- unlocked
- milestoned
- demilestoned
Ú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 Acciones de GitHub".

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.

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 Acciones de GitHub".

Por ejemplo, puedes ejecutar un flujo de trabajo cuando un miembro ha sido creado o eliminado.

on:
  label:
    types: [created, deleted]

Evento de miembro: member

Ejecuta tu flujo de trabajo en cualquier momento en que se produzca el evento de member. Más de un tipo de actividad desencadena este evento. Para obtener más información sobre la API REST, consulta "Colaboradores" en la documentación del programador de GitHub.

Carga del evento Webhook Tipos de actividad GITHUB_SHA GITHUB_REF
member - added
- 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 Acciones de GitHub".

Por ejemplo, puedes ejecutar un flujo de trabajo cuando un miembro ha sido agregado o eliminado.

on:
  member:
    types: [added, 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.

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 Acciones de GitHub".

Por ejemplo, puedes ejecutar un flujo de trabajo cuando un miembro ha sido abierto o eliminado.

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.

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.

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 Acciones de GitHub".

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.

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 Acciones de GitHub".

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.

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 Acciones de GitHub".

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.

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 para Acciones de GitHub".

Por ejemplo, puede ejecutar un flujo de trabajo cuando una solicitud de extracción ha sido asignada, abierta, sincronizada o reabierta.

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 obtener más información acerca de GITHUB_TOKEN, consulta "Entornos virtuales para Acciones de GitHub".

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
revisión_solicitud de extracción - submitted
- edited
- dismissed
Ú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 Acciones de GitHub".

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 obtener más información acerca de GITHUB_TOKEN, consulta "Entornos virtuales para Acciones de GitHub".

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 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 Acciones de GitHub".

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 obtener más información acerca de GITHUB_TOKEN, consulta "Entornos virtuales para Acciones de GitHub".

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

Evento de lanzamiento: release

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 Acciones de GitHub".

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.

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.

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 Acciones de GitHub".

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: planificar

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: Acciones de GitHub 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

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 envío 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

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos