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 los resultados de cada paso en tu flujo de trabajo, cancelar un flujo de trabajo pendiente, depurar y volver a ejecutar un flujo de trabajo fallido, buscar y descargar registros, y descargar artefactos.

Acciones de GitHub is available with GitHub gratis, GitHub Pro, Equipo de GitHub, and Nube de GitHub Enterprise. Para obtener más información, consulta "Productos de GitHub."

En este artículo

Acerca de los permisos de flujo de trabajo

Cualquier usuario con acceso de lectura en un repositorio habilitado para Acciones de GitHub puede ver toda la información sobre un flujo de trabajo. El acceso de lectura te permite descargar artefactos y ver los archivos del flujo de trabajo, el historial de ejecución y los registros.

Al menos debes tener acceso de nivel de escritura para cancelar o volver a realizar ejecuciones del flujo de trabajo.

Para obtener más información, consulta "Permisos de acceso en GitHub."

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. 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 descargar registros y construir artefactos.

Imagen de ejecución de flujo de trabajo anotado

Acciones de GitHub 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. Acciones de GitHub se ejecutan como un paso en un flujo de trabajo. Para obtener más información sobre la API de verificaciones, consulta "Verificaciones" en la documentación del programador de GitHub.

Ver el historial de tu 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 "Acerca de Acciones de GitHub".

Cada trabajo incluye un paso "Configurar trabajo" y un paso "Completar trabajo" de forma predeterminada, y las acciones configuradas en el archivo de flujo de trabajo.

  1. En GitHub, visita la página principal del repositorio.

  2. En el nombre de tu repositorio, haz clic en Acciones.

    Pestaña Acciones en la navegación del repositorio principal

  3. En la barra lateral izquierda, haz clic en el flujo de trabajo que deseas ver.

    Lista de flujo de trabajo en la barra lateral izquierda

  4. En "Ejecuciones de flujo de trabajo", haz clic en el nombre de la ejecución que deseas 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.

  1. En GitHub, visita la página principal del repositorio.

  2. En el nombre de tu repositorio, haz clic en Acciones.

    Pestaña Acciones en la navegación del repositorio principal

  3. En la barra lateral izquierda, haz clic en el flujo de trabajo que deseas ver.

    Lista de flujo de trabajo en la barra lateral izquierda

  4. En "Ejecuciones de flujo de trabajo", haz clic en el nombre de la ejecución que deseas 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

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.

GitHub almacena registros completos de construcción y artefactos durante 90 días para las solicitudes de inserción y 30 días para las solicitudes de extracción. El período de retención para una solicitud de extracción se reinicia cada vez que alguien sube la solicitud de extracción.

  1. En GitHub, visita la página principal del repositorio.

  2. En el nombre de tu repositorio, haz clic en Acciones.

    Pestaña Acciones en la navegación del repositorio principal

  3. En la barra lateral izquierda, haz clic en el flujo de trabajo que deseas ver.

    Lista de flujo de trabajo en la barra lateral izquierda

  4. En "Ejecuciones de flujo de trabajo", haz clic en el nombre de la ejecución que deseas ver.

    Nombre de la ejecución de flujo de trabajo

  5. En la barra lateral izquierda, haz clic en el trabajo que deseas ver.

    Lista de trabajos en la barra lateral izquierda

  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.

  1. En GitHub, visita la página principal del repositorio.

  2. En el nombre de tu repositorio, haz clic en Acciones.

    Pestaña Acciones en la navegación del repositorio principal

  3. En la barra lateral izquierda, haz clic en el flujo de trabajo que deseas ver.

    Lista de flujo de trabajo en la barra lateral izquierda

  4. En "Ejecuciones de flujo de trabajo", haz clic en el nombre de la ejecución que deseas ver.

    Nombre de la ejecución de flujo de trabajo

  5. En la barra lateral izquierda, haz clic en el trabajo que deseas ver.

    Lista de trabajos en la barra lateral izquierda

  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 registros y artefactos

Los artefactos son los archivos creados cuando construyes y pruebas tu código. Por ejemplo, los artefactos podrían incluir archivos binarios o de paquete, resultados de pruebas, capturas de pantalla o archivos de registro. Cuando se completa una ejecución, estos archivos se eliminan del entorno virtual que ejecutó tu flujo de trabajo y se archivan para que los descargues.

  1. En GitHub, visita la página principal del repositorio.

  2. En el nombre de tu repositorio, haz clic en Acciones.

    Pestaña Acciones en la navegación del repositorio principal

  3. En la barra lateral izquierda, haz clic en el flujo de trabajo que deseas ver.

    Lista de flujo de trabajo en la barra lateral izquierda

  4. En "Ejecuciones de flujo de trabajo", haz clic en el nombre de la ejecución que deseas 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

  6. Para descargar artefactos, usa el menú desplegable Artefactos y selecciona el artefacto que deseas descargar.

    Menú desplegable de artefactos

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.

Estos registros adicionales se controlan estableciendo secretos en el repositorio que contiene el flujo de trabajo. Para obtener más información sobre el establecimiento de secretos, consulta "Creating and using secrets (encrypted variables)" (Crear y usar secretos [variables cifradas]).

Habilitar el registro de diagnóstico del ejecutor

El registro de diagnóstico del ejecutor proporciona archivos de registro adicionales que contienen información acerca de cómo un ejecutor está ejecutando una acción. 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 más información sobre la descarga de registros, consulta "Descargar registros y artefactos".

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

Lectura adicional

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos