Skip to main content

Adición de un distintivo de estado de flujo de trabajo

Puedes mostrar una insignia de estado en tu repositorio para indicar el estado de tus flujos de trabajo.

Nota: Actualmente los ejecutores hospedados en GitHub no se admiten en GitHub Enterprise Server. Puede ver más información sobre la compatibilidad futura planeada en GitHub public roadmap.

Nota: No se puede acceder externamente a los distintivos de flujo de trabajo de un repositorio privado, por lo que no podrás insertarlos en un sitio externo ni vincularlos desde ellos.

Una insignia de estado muestra si un flujo de trabajo falla o pasa actualmente. Un lugar común para agregar un distintivo de estado es el archivo README.md del repositorio, pero puede agregarlo a la página web que quiera. Predeterminadamente, las insignias muestran el estado de tu rama predeterminada. También puede mostrar el estado de la ejecución de un flujo de trabajo para una rama o evento específicos mediante los parámetros de consulta branch y event en la URL.

ejemplo de insignia de estado

Para agregar un distintivo de estado del flujo de trabajo a tu archivo README.md, primero debes buscar la dirección URL del distintivo de estado que quieres mostrar. Luego, puedes usar Markdown para mostrar el distintivo como imagen en tu archivo README.md. Para más información sobre el marcado de una imagen en Markdown, consulta "Sintaxis de escritura y formato básicos".

Usar el nombre de archivo del flujo de trabajo

Para crear la dirección URL del distintivo de estado de un flujo de trabajo, puedes usar el nombre del archivo de flujo de trabajo:

<HOSTNAME>/<OWNER>/<REPOSITORY>/actions/workflows/<WORKFLOW_FILE>/badge.svg

Para mostrar el distintivo de estado del flujo de trabajo en tu archivo README.md, usa el marcado Markdown para insertar imágenes. Para más información sobre el marcado de una imagen en Markdown, consulta "Sintaxis de escritura y formato básicos".

Por ejemplo, agrega el Markdown siguiente a tu archivo README.md para agregar un distintivo de estado de un flujo de trabajo con la ruta de acceso al archivo .github/workflows/main.yml. En el repositorio, OWNER es la organización github y el nombre REPOSITORY es docs.

![example workflow](https://github.com/github/docs/actions/workflows/main.yml/badge.svg)

Uso del parámetro branch

Para mostrar el estado de una ejecución de flujo para una rama específica, agrega ?branch=<BRANCH_NAME> al final de la dirección URL al distintivo de estado.

Por ejemplo, agrega el Markdown siguiente al archivo README.md para mostrar 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)

Uso del parámetro event

Si quieres mostrar el estado de las ejecuciones del flujo de trabajo que desencadenó el evento push, agrega ?event=push al final de la dirección URL del distintivo de estado.

Por ejemplo, agrega el Markdown siguiente a tu archivo README.md para mostrar un distintivo con el estado de las ejecuciones del flujo de trabajo que desencadenó el evento push, con lo que se 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)