👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


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.

GitHub Actions se encuentra disponible con GitHub Free, GitHub Pro, GitHub Free para organizaciones, GitHub Team, GitHub Enterprise Cloud, y GitHub One. GitHub Actions no está disponible para repositorios privados que pertenezcan a cuentas que utilicen planes tradicionales por repositorio. Para obtener más información, consulta la sección "Productos de GitHub".

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. For more information, see "Webhooks." For more information about the on syntax, see "Workflow syntax for GitHub Actions."

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

  1. Se produce un evento en tu repositorio, y el webhook del evento resultante tiene una confirmación de SHA y una referencia de Git asociadas.

  2. El directorio .github/workflows en tu repositorio se busca para los archivos de flujo de trabajo en la confirmación SHA o la referencia de Git asociadas. Los archivos de flujo de trabajo deben estar presentes en la confirmación SHA o la referencia de Git que se debe tener en cuenta.

    Por ejemplo, si el evento se produjo en una rama particular del repositorio, los archivos de flujo de trabajo deben estar presentes en el repositorio en esa rama.

  3. Se inspeccionarán los archivos de flujo de trabajo para esa confirmación de SHA y referencia de Git, y se activará una nueva ejecución de flujo de trabajo para cualquier flujo de trabajo que tenga valores on: que coincidan con el evento desencadenante.

    El flujo de trabajo se ejecuta en el código de tu repositorio en la misma confirmación SHA y la referencia de Git que desencadenó el evento. Cuando se ejecuta un flujo de trabajo, GitHub establece las variables de entorno GITHUB_SHA (confirmar SHA) y GITHUB_REF (referencia de Git) en el entorno del ejecutor. Para obtener más información, consulta "Usar variables de entorno".

Nota: No puedes activar nuevas ejecuciones de flujo de trabajo usando el GITHUB_TOKEN. Para obtener más información, consulta "Activar nuevos flujos de trabajo mediante un token de acceso personal".

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]

Ejemplo utilizando eventos múltiples con tipos de actividad o configuración

Si necesitas especificar tipos de actividad o configuración para un evento, debes configurar cada evento por separado. Debes agregar dos puntos (:) a todos los eventos, incluyendo aquellos sin configuración.

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. For information about the REST API, see "Check runs."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
check_run- creado
- resolicitado
- completado
- requested_action


Última confirmación en la rama por defectoRama 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. For information about the REST API, see "Check suites."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Nota: Para evitar flujos de trabajo recurrentes, este evento no activa flujos de trabajo si la comprobación de suite fue creada por GitHub Actions.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
check_suite- completado
- solicitado
- resolicitado


Última confirmación en la rama por defectoRama 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. For information about the REST API, see "Create a reference."

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
create (crear)n/aÚltima confirmación en la rama o etiqueta creadaRama 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. For information about the REST API, see "Delete a reference."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
delete (eliminar)n/aÚltima confirmación en la rama por defectoRama 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 una referencia de Git. For information about the REST API, see "Deployments."

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
deploymentn/aConfirmación de implementaciónRama 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 una referencia de Git. For information about the REST API, see "Create a deployment status."

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
deployment_statusn/aConfirmación de implementaciónRama 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. For information about the REST API, see "Create a fork."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
bifurcaciónn/aÚltima confirmación en la rama por defectoRama 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.

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
gollumn/aÚltima confirmación en la rama por defectoRama 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. For information about the REST API, see "Issue comments."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
comentario_propuesta- created
- edited
- deleted


Última confirmación en la rama por defectoRama 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. For information about the REST API, see "Issues."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
propuestas- opened
- edited
- deleted
- transferred
- pinned
- unpinned
- closed
- reopened
- assigned
- unassigned
- labeled
- unlabeled
- locked
- unlocked
- milestoned
- demilestoned














Última confirmación en la rama predeterminadaRama 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. For information about the REST API, see "Labels."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
etiqueta- created
- edited
- deleted


Última confirmación en la rama por defectoRama 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. For information about the REST API, see "Milestones."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
hito- created
- closed
- opened
- edited
- deleted




Última confirmación en la rama por defectoRama 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 hito ha sido opened o 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. For information about the REST API, see "Pages."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
page_buildn/aÚltima confirmación en la rama por defecton/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. For information about the REST API, see "Projects."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
project- created
- updated
- closed
- reopened
- edited
- deleted





Última confirmación en la rama por defectoRama 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. For information about the REST API, see "Project cards."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
project_card- created
- moved
- converted to an issue
- edited
- deleted



Última confirmación en la rama por defectoRama 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. For information about the REST API, see "Project columns."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
project_column- created
- updated
- moved
- deleted


Última confirmación en la rama por defectoRama 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. For information about the REST API, see "Edit repositories."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
publicn/aÚltima confirmación en la rama por defectoRama 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. For information about the REST API, see "Pull requests."

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 WebhookTipos de actividadGITHUB_SHAGITHUB_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_REFRama 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".

Por ejemplo, puedes ejecutar un flujo de trabajo cuando una solicitud de extracción ha sido assigned (asignada), opened, syncronize o 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. For information about the REST API, see "Pull request reviews."

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
pull_request_review- submitted
- edited
- dismissed

Última confirmación de fusión en la rama GITHUB_REFRama 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. For information about the REST API, see Review comments.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
pull_request_review_comment- created
- edited
- deleted

Última confirmación de fusión en la rama de GITHUB_REFRama 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. For more information, see "Get a single commit"".

Ejecuta tu flujo de trabajo cuando alguien sube una rama a tu repositorio, lo que activa el evento push.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
subirn/aConfirmació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 del paquete del registro: registry_package

Ejecuta tu flujo de trabajo en cualquier momento en que un paquete es publish (publicado) o updated (actualizado). Para obtener más información, consulta "Administrar paquetes con GitHub Packages".

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
registry_package- publicado
- actualizado
Confirmación del paquete publicadoRama o etiqueta del paquete publicado

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 paquete ha sido publicado.

on:
  registry_package:
    types: [published]

Evento de lanzamiento: release

Nota: El evento release no se activará para los lanzamientos en borrador.

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. For information about the REST API, see "Releases."

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
lanzamiento- published
- unpublished
- created
- edited
- deleted
- prereleased
- released





Última confirmación en el lanzamiento etiquetadoEtiqueta 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. For information about the REST API, see Statuses.

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
estadon/aÚltima confirmación en la rama por defecton/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. For information about the REST API, see "Starring."

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Carga del evento WebhookTipos de actividadGITHUB_SHAGITHUB_REF
ver- comenzadoÚltima confirmación en la rama por defectoRama 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 WebhookTipos de actividadGITHUB_SHAGITHUB_REF
n/an/aÚltima confirmación en la rama por defectoRama 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. El intervalo más corto en el que puedes programar flujos de trabajo es cada 5 minutos.

Este ejemplo activa el flujo de trabajo cada 15 minutos:

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:

OperadorDescripciónEjemplo
*Cualquier valor* * * * * se ejecuta todos los días a cada minuto.
,Separador de la lista de valores2,10 4,5 * * * se ejecuta en el minuto 2 y 10 de la cuarta y quinta hora de cada día.
-Rango de valores0 4-6 * * * se ejecuta en el minuto 0 de la cuarta, quinta y sexta hora.
/Valores del paso20/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 WebhookTipos de actividadGITHUB_SHAGITHUB_REF
repository_dispatchn/aÚltima confirmacion en la rama de GITHUB_REFRama que recibió el envío

Nota: Este evento solo desencadenará una ejecución de flujo de trabajo si el archivo de dicho flujo se encuentra en la rama master o en la predeterminada.

Puedes utilizar la API de GitHub para desencadenar un evento de webhook llamado repository_dispatch cuando quieras desencadenar un flujo de trabajo para una actividad que sucede fuera de GitHub. For more information, see "Create a repository dispatch event."

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

Predeterminadamente, todos los event_types desencadenan la ejecución de un flujo de trabajo. Puedes limitar tu flujo de trabajo para que se ejecute cuando un valor específico de event_type se envíe en la carga útil del webhook de repository_dispatch. Tú defines los tipos de evento enviados en la carga útil de repository_dispatch cuando creas el repositorio.

on:
  repository_dispatch:
    types: [opened, deleted]

Activar nuevos flujos de trabajo mediante un token de acceso personal

Cuando utilizas el GITHUB_TOKEN del repositorio para realizar tareas por parte de la app de GitHub Actions, los eventos que GITHUB_TOKEN desencadena no crearán una ejecución de flujo de trabajo. Esto impide que crees ejecuciones de flujo de trabajo recursivas por accidente. Por ejemplo, si un flujo de trabajo sube código utilizando el GITHUB_TOKEN del repositorio, no se ejecutará un nuevo flujo de trabajo aún si el repositorio contiene alguno configurado para ejecutarse cuando ocurran eventos de subida de información. Para obtener más información, consulta "Autenticar con el GITHUB_TOKEN".

Si deseas activar un flujo de trabajo desde una ejecución de flujo de trabajo, puedes desencadenar el evento mediante un token de acceso personal. Necesitaras crear un token de acceso personal y almacenarlo como un secreto. Para minimizar tus costos de uso de GitHub Actions, asegúrate de no crear ejecuciones de flujo de trabajo recurrentes o involuntarias. Para obtener más información, consulta "Crear y almacenar secretos cifrados".

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos