👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.


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.

Administrar una ejecución de flujo de trabajo

Puedes ver el estado y resultados de cada paso en tu flujo de trabajo, cancelar un flujo de trabajo pendiente, ver los minutos de ejecución facturables para jobs, depurar y volver a ejecutar un flujo de trabajo fallido, buscar y descargar bitácoras y descargar artefactos.

GitHub Actions se encuentra disponible con GitHub Free, GitHub Pro, GitHub Free para organizaciones, GitHub Team, GitHub Enterprise Cloud, y GitHub One. GitHub Actions no está disponible para repositorios privados que pertenezcan a cuentas que utilicen planes tradicionales por repositorio. Para obtener más información, consulta la sección "Productos de GitHub".

En este artículo

Acerca de la administración del flujo de trabajo

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. Si la ejecución está en curso, puedes cancelarla. 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.

Imagen de ejecución de flujo de trabajo anotado

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. For more information about the Checks API, see "Checks."

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 tu historial de flujo de trabajo

Puedes ver cada trabajo en una ejecución de flujo de trabajo y cada paso en un trabajo. Para obtener más información, consulta "Conceptos clave para GitHub Actions". Las personas con acceso de lectura en el repositorio pueden llevar a cabo estos pasos.

Adicionalmente a los pasos configurados en el archivo de flujo de trabajo, cada job también incluye tareas adicionales para iniciar y completar la ejecución del job. Estos pasos se registran en la ejecución de flujo de trabajo como "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 GitHub, 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. Debajo 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. De manera opcional, si la ejecución falló, para volver a ejecutar el flujo de trabajo, en la esquina superior derecha del flujo de trabajo, usa el menú desplegable Re-run checks (Volver a ejecutar verificaciones) y selecciona Re-run all checks (Volver a ejecutar todas las verificaciones).
    Volver a ejecutar el menú desplegable de verificaciones

Cancelar una ejecución de flujo de trabajo

Cuando cancelas una ejecución de flujo de trabajo, GitHub cancela todos los pasos que forman parte de ese flujo de trabajo. Las personas con acceso de escritura en el repositorio pueden llevar a cabo estos pasos.

  1. En GitHub, 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. Debajo 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 del flujo de trabajo, haz clic en Cancelar el conjunto de verificaciones.
    Botón de cancelar el conjunto de verificaciones

Visualizar los minutos de ejecución facturables para jobs

Puedes ver el tiempo de ejecución de un job, incluyendo los minutos facturables que este job ha acumulado.

Los minutos de ejecución facturables para un job solo se muestran en aquellos jobs que se ejecutan en repositorios privados que utilizan ejecutores hospedados en GitHub. No hay minutos facturables cuando se utiliza GitHub Actions en repositorios públicos o para trabajos que se ejecutan en ejecutores auto-hospedados.

  1. En GitHub, 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. Debajo 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 del resumen del job, da clic en Detalles de tiempo facturable y de ejecución.

    Enlace para los detalles de tiempo facturable y de ejecución

    Nota: El tiempo facturable que se muestra no incluye ningún multiplicador de minutos o de redondeo. Para ver tu uso total de GitHub Actions, incluyendo los multiplicadores de minutos y de redondeo, consulta la sección "Visualizar tu uso de GitHub Actions".

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. Las personas con acceso de lectura en el repositorio pueden llevar a cabo estos pasos.

GitHub almacena todas las bitácoras de compilación y artefactos por 90 días.

  1. En GitHub, 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. Debajo 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 barra lateral izquierda, da clic en el job que quieres ver.
    Listado de jobs en la barra lateral izqueirda
  6. Para expandir el registro de un paso fallido, haz clic en el paso.
    Nombre de paso fallido
  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. Puedes copiar el enlace desde la barra de direcciones de tu navegador 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. Las personas con acceso de lectura en el repositorio pueden llevar a cabo estos pasos.

  1. En GitHub, 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. Debajo 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 barra lateral izquierda, da clic en el job que quieres ver.
    Listado de jobs en la barra lateral izqueirda
  6. Para expandir cada paso que deseas incluir en tu búsqueda, haz clic en el paso.
    Nombre del paso
  7. 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 las 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 la sección "Datos persistentes del flujo de trabajo que utiliza artefactos". Las personas con acceso de lectura en el repositorio pueden llevar a cabo estos pasos.

  1. En GitHub, 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. Debajo 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. Para descargar registros, usa el menú desplegable Descargar registros y selecciona los registros que deseas descargar.
    Menú desplegable para descargar registros

Borrar bitácoras

Puedes borrar los archivos de bitácora de tu ejecución de flujo de trabajo. Las personas con acceso de escritura en el repositorio pueden llevar a cabo estos pasos.

  1. En GitHub, 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. Debajo 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. 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.
    Delete all logsDespués de borrar las bitácoras, el botón Borrar todas las bitácoras se elimina para indicar que no quedan archivos de bitácora en la ejecución del flujo de trabajo.

Habilitar registro de depuración

Si los registros de flujo de trabajo no proporcionan suficiente detalle para diagnosticar por qué un flujo de trabajo o paso no funciona como se espera, puedes habilitar más registros de depuración.

Estas bitácoras extra se habilitan configurando los secretos en el repositorio que contiene el flujo de trabajo, así que aplicarán los mismos requisitos de los permisos:

  • Para crear secretos a nivel organizacional, deberás tener acceso de administrador.
  • Para crear secretos para un repositorio de una cuenta de usuario, deberás ser el propietario de éste. Para crear secretos para un repositorio de una organización, deberás tener acceso de administrador.
  • Para crear secretos utilizando la API de REST, deberás contar con acceso de escritura al repositorio. For more information, see "GitHub Actions secrets API."

Para obtener más información sobre la configuración de secretos, consulta la sección "Crear y utilizar secretos cifrados".

Habilitar el registro de diagnóstico del ejecutor

El registro de diagnóstico en bitácoras para los ejecutores proporciona archivos de bitácora adicionales que contienen información acerca de como se ejecutan los jobs en estos. Los archivos de registro adicionales se agregan al archivo de registro:

  • El registro del proceso del ejecutor, que incluye información acerca de la coordinación y la configuración de los ejecutores para ejecutar tareas.
  • El registro del proceso del trabajador, que registra la ejecución de una tarea.
  1. Para habilitar el registro de diagnóstico del ejecutor, establece el siguiente secreto en el repositorio que contiene el flujo de trabajo: ACTIONS_RUNNER_DEBUG en true.

  2. Para descargar los registros de diagnóstico del ejecutor, descarga el archivo de registro del flujo de trabajo. Los registros de diagnóstico del ejecutor se encuentran en la carpeta correner-diagnostic-logs. Para obtener información sobre descargar las bitácoras, consulta la sección "Descargar bitácoras".

Habilitar el registro de depuración del paso

El registro de depuración del paso aumenta el nivel de detalle de los registros de una tarea durante y después de la ejecución de una tarea.

  1. Para habilitar el registro de depuración del paso, debes establecer el siguiente secreto en el repositorio que contiene el flujo de trabajo: ACTIONS_RUNNER_DEBUG en true.

  2. Después de establecer el secreto, se muestran más eventos de depuración en los registros del paso. Para obtener más información, consulta "Ver registros para diagnosticar fallas".

Leer más

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos