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, Nube de GitHub Enterprise, and GitHub One. Acciones de GitHub is not available for private repositories owned by accounts using legacy per-repository 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".

The following steps occur to trigger a workflow run:

  1. An event occurs on your repository, and the resulting event webhook has an associated commit SHA and Git ref.

  2. The .github/workflows directory 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.

  3. 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) and GITHUB_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 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.

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

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

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

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

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

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

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

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

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

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

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

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 Acciones de GitHub 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 Acciones de GitHub usage costs, ensure that you don't create recursive or unintended workflow runs. For more information, see "Creating and storing encrypted secrets."

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos