Nota: Los ejecutores hospedados en GitHub no son compatibles con GitHub Enterprise Server actualmente. Puedes encontrar más información sobre el soporte que se tiene planeado en el futuro en el Itinerario público de GitHub.
Una insignia de estado muestra si un flujo de trabajo falla o pasa actualmente. Un lugar común para agregar una insignia de estado es el archivo README.md
de tu repositorio, pero puedes agregarlo a cualquier página web que quieras. Predeterminadamente, las insignias muestran el estado de tu rama predeterminada. También puedes mostrar el estado de la ejecución de un flujo de trabajo para una rama o evento específicos utilizando los parámetros de query branch
y event
en la URL.
Referencias el flujo de trabajo por el nombre de tu archivo de flujo de trabajo.
![flujo de trabajo de ejemplo](<HOSTNAME>/<OWNER>/<REPOSITORY>/actions/workflows/<WORKFLOW_FILE>/badge.svg)
Usar el nombre de archivo del flujo de trabajo
Este ejemplo de Markdown agrega una credencial de estado para un flujo de trabajo con la ruta de archivo .github/workflows/main.yml
. El OWNER
del repositorio es la organización github
y el nombre del REPOSITORY
es docs
.
![flujo de trabajo de ejemplo](https://github.com/github/docs/actions/workflows/main.yml/badge.svg)
Utilizar el parámetro branch
Este ejemplo de Markdown añade un distintivo de estado para una rama con el nombre feature-1
.
![example branch parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?branch=feature-1)
Utilizar el parámetro event
Este ejemplo de lenguaje de marcado agrega una insignia que muestra el estado de las ejecuciones de flujo de trabajo que se activan con el evento push
, lo cual mostrará el estado de la compilación del estado actual de dicha rama.
![example event parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?event=push)