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

> \[!NOTE]
> Actualmente los ejecutores hospedados por GitHub Enterprise Server no se admiten en GitHub.

> \[!NOTE]
> 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. Si no hay ninguna ejecución de flujo de trabajo en la rama predeterminada, se mostrará el estado de la ejecución más reciente en todas las ramas. 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.

![Captura de pantalla de una notificación de estado de flujo de trabajo. De derecha a izquierda, se muestra: el logotipo de GitHub, el nombre del flujo de trabajo ("Demostración de Acciones de GitHub") y el estado ("paso").](/assets/images/help/repository/actions-workflow-status-badge.png)

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 imágenes en Markdown, consulta [Sintaxis básica de redacción y formato](/es/enterprise-server@3.22/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images).

## Uso de la interfaz de usuario

Puedes crear un distintivo de estado de flujo de trabajo directamente en la interfaz de usuario mediante el nombre del archivo de flujo de trabajo, el parámetro de rama y el parámetro de evento.

1. En GitHub, navegue hasta la página principal del repositorio.
2. En el nombre del repositorio, haz clic en **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-play" aria-label="play" role="img"><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Zm4.879-2.773 4.264 2.559a.25.25 0 0 1 0 .428l-4.264 2.559A.25.25 0 0 1 6 10.559V5.442a.25.25 0 0 1 .379-.215Z"></path></svg> Actions**.

   ![Captura de pantalla de las pestañas del repositorio "github/docs". La pestaña "Proyectos" aparece resaltada con un contorno naranja.](/assets/images/help/repository/actions-tab-global-nav-update.png)
3. En la barra lateral izquierda, da clic en el flujo de trabajo que quieras ver.

   ![Captura de pantalla de la barra lateral izquierda de la pestaña "Acciones". Un flujo de trabajo, "CodeQL", se destaca en naranja oscuro.](/assets/images/help/actions/superlinter-workflow-sidebar.png)
4. En el lado derecho de la página, junto al campo "Filter workflow runs", haz clic en <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Show workflow options" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg> para mostrar un menú desplegable y haz clic en **Create status badge**.
5. Opcionalmente, selecciona una rama si quieres mostrar el distintivo de estado de una rama diferente a la predeterminada.
6. Opcionalmente, selecciona el evento que desencadenará el flujo de trabajo.
7. Haz clic en **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copy" aria-label="copy" role="img"><path d="M0 6.75C0 5.784.784 5 1.75 5h1.5a.75.75 0 0 1 0 1.5h-1.5a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-1.5a.75.75 0 0 1 1.5 0v1.5A1.75 1.75 0 0 1 9.25 16h-7.5A1.75 1.75 0 0 1 0 14.25Z"></path><path d="M5 1.75C5 .784 5.784 0 6.75 0h7.5C15.216 0 16 .784 16 1.75v7.5A1.75 1.75 0 0 1 14.25 11h-7.5A1.75 1.75 0 0 1 5 9.25Zm1.75-.25a.25.25 0 0 0-.25.25v7.5c0 .138.112.25.25.25h7.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25Z"></path></svg> Copy status badge Markdown**.
8. Copia el Markdown en el archivo `README.md`.

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

```text
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 imágenes en Markdown, consulta [Sintaxis básica de redacción y formato](/es/enterprise-server@3.22/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images).

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

```markdown
![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`.

```markdown
![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.

```markdown
![example event parameter](https://github.com/github/docs/actions/workflows/main.yml/badge.svg?event=push)
```