Utilizar bitácoras de ejecución de flujo de trabajo

Puedes ver, buscar y descargar las bitácoras de cada job en una ejecución de flujo de trabajo.

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.

Puedes ver si una ejecución de flujo de trabajo está en curso o completa desde la página de ejecución del flujo de trabajo. Debes haber iniciado sesión en una cuenta de GitHub para ver la información de ejecución del flujo de trabajo, incluyendo los casos de repositorios públicos. Para obtener más información, consulta "Permisos de acceso en GitHub".

Si la ejecución está completa, puedes ver si el resultado fue exitoso, fallido, cancelado o neutral. Si la ejecución falló, puedes ver y buscar en los registros de construcción para diagnosticar la falla y volver a ejecutar el flujo de trabajo. También puedes ver los minutos de ejecución facturables para jobs, o descargar bitácoras y artefactos de compilación.

GitHub Actions usa la API de verificaciones para generar estados, resultados y registros para un flujo de trabajo. GitHub crea una nueva comprobación de suite para cada ejecución de flujo de trabajo. La comprobación de suite contiene una ejecución de comprobación para cada trabajo en el flujo de trabajo, y cada trabajo incluye diferentes pasos. GitHub Actions se ejecutan como un paso en un flujo de trabajo. Para obtener más información acerca de la API de Verificaciones, consulta la sección "Verificaciones".

Nota: Garantiza que solo confirmes los archivos de flujo de trabajo válidos en tu repositorio. Si .github/workflows contiene un archivo de flujo de trabajo inválido, GitHub Actions generará una ejecución de flujo de trabajo fallida por cada confirmación nueva.

Ver registros para diagnosticar fallas

Si falla la ejecución de su flujo de trabajo, puedes ver qué paso provocó el error y revisar los registros de construcción del paso que falló para solucionar el problema. Puedes ver el tiempo que demoró cada paso en ejecutarse. También puedes copiar un enlace permanente a una línea específica en el archivo de registro para compartir con tu equipo. Se requiere tener acceso de lectura en el repositorio para llevar a cabo estos pasos.

Adicionalmente a los pasos que se configuraron en el archivo de flujo de trabajo, GitHub agrega dos pasos adicionales a cada job para configurar y completar la ejecución del flujo de trabajo. Estos pasos se registran en la ejecución del flujo de trabajo con los nombres de "Set up job" y "Complete job".

Para jobs que se ejecutan en ejecutores hospedados en GitHub, "Set up job" registra los detalles del ambiente virtual del ejecutor, e incluye un enlace a la lista de herramientas pre-instaladas que estuvieron presentes en la máquina del ejecutor.

  1. En your GitHub Enterprise Server instance, visita la página principal del repositorio.

  2. Debajo del nombre de tu repositorio, da clic en Acciones. Pestaña de acciones en la navegación del repositorio principal

  3. En la barra lateral izquierda, da clic en el flujo de trabajo que quieres ver. Lista de flujos de trabajo en la barra lateral izquierda

  4. Desde la lista de ejecuciones de flujo de trabajo, da clic en el nombre de la ejecución que quieres ver. Nombre de la ejecución de flujo de trabajo

  5. Debajo de Jobs o en la gráfica de visualización, da clic en el job que quieras ver. Limpiar el job de código base

  6. Cualquier paso que falle se expandirá automáticamente para mostrar los resultados.

    Resultados del flujo de trabajo de Super linter

  7. De manera opcional, para obtener un enlace a una línea específica de los registros, haz clic en el número de línea del paso. Ahora podrás copiar el enlace de la barra de direcciones de tu buscador web.

    Botón para copiar enlace

Buscar registros

Puedes buscar en los registros de construcción un paso en particular. Cuando buscas registros, solo los pasos ampliados se incluyen en los resultados. Se requiere tener acceso de lectura en el repositorio para llevar a cabo estos pasos.

  1. En your GitHub Enterprise Server instance, visita la página principal del repositorio.

  2. Debajo del nombre de tu repositorio, da clic en Acciones. Pestaña de acciones en la navegación del repositorio principal

  3. En la barra lateral izquierda, da clic en el flujo de trabajo que quieres ver. Lista de flujos de trabajo en la barra lateral izquierda

  4. Desde la lista de ejecuciones de flujo de trabajo, da clic en el nombre de la ejecución que quieres ver. Nombre de la ejecución de flujo de trabajo

  5. Debajo de Jobs o en la gráfica de visualización, da clic en el job que quieras ver. Limpiar el job de código base

  6. En el cuadro de búsqueda Buscar registros en la esquina superior derecha de la salida del registro, escribe una consulta de búsqueda.

    Cuadro de búsqueda para buscar registros

Descargar bitácoras

Puedes descargar los archivos de bitácora desde tu ejecución de flujo de trabajo. También puedes descargar los artefactos de un flujo de trabajo. Para obtener más información, consulta "Conservar datos de flujo de trabajo mediante artefactos." Se requiere tener acceso de lectura en el repositorio para llevar a cabo estos pasos.

  1. En your GitHub Enterprise Server instance, visita la página principal del repositorio.

  2. Debajo del nombre de tu repositorio, da clic en Acciones. Pestaña de acciones en la navegación del repositorio principal

  3. En la barra lateral izquierda, da clic en el flujo de trabajo que quieres ver. Lista de flujos de trabajo en la barra lateral izquierda

  4. Desde la lista de ejecuciones de flujo de trabajo, da clic en el nombre de la ejecución que quieres ver. Nombre de la ejecución de flujo de trabajo

  5. Debajo de Jobs o en la gráfica de visualización, da clic en el job que quieras ver. Limpiar el job de código base

  6. En la esquina superior derecha, haz clic en y selecciona Descargar archivo de bitácora.

    Menú desplegable para descargar registros

Borrar bitácoras

Puedes borrar los archivos de bitácora de tu ejecución de flujo de trabajo. Se requiere tener acceso de escritura en el repositorio para llevar a cabo estos pasos.

  1. En your GitHub Enterprise Server instance, visita la página principal del repositorio.

  2. Debajo del nombre de tu repositorio, da clic en Acciones. Pestaña de acciones en la navegación del repositorio principal

  3. En la barra lateral izquierda, da clic en el flujo de trabajo que quieres ver. Lista de flujos de trabajo en la barra lateral izquierda

  4. Desde la lista de ejecuciones de flujo de trabajo, da clic en el nombre de la ejecución que quieres ver. Nombre de la ejecución de flujo de trabajo

  5. En la esquina superior derecha, haz clic en el .

    Icono de Kebab horizontal

  6. Para borrar los archivos de bitácora, da clic en el botón Borrar todas las bitácoras y revisa el aviso de confirmación.

    Borrar todas las bitácoras

Después de borrar las bitácoras, el botón de Borrar todas las bitácoras se elimina para indicar que ya no quedan archivos en la ejecución de flujo de trabajo.

Visualizar las bitácoras con CLI de GitHub

Para aprender más sobre el CLI de GitHub, consulta la sección "Acerca del CLI de GitHub".

Para ver la bitácora de un job específico, utiliza el subcomando run view. Reemplaza a run-id con la ID de la ejecución de la cual quieres ver las bitácoras. CLI de GitHub devuelve un menú interactivo para que elijas un job de la ejecución. Si no especificas una run-id, CLI de GitHub devuelve un menú interactivo para que elijas una ejecución reciente y luego devuelve otro menú interactivo para que elijas un job de la ejecución.

gh run view run-id --log

También puedes utilizar el marcador --job para especificar una ID de job. Reemplaza a job-id con la ID del job del cual quieres ver las bitácoras.

gh run view --job job-id --log

Puedes utilizar grep para buscar la bitácora. Por ejemplo, este comando devolverá todas las entradas de la bitácora que contenga la palabra error.

gh run view --job job-id --log | grep error

Para filtrar las bitácoras para encontrar cualquier tipo de paso fallido, utiliza --log-failed en vez de --log.

gh run view --job job-id --log-failed

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.