{"meta":{"title":"Flujos de trabajo de solución de problemas","intro":"Puede usar las herramientas de GitHub Actions para depurar los flujos de trabajo.","product":"GitHub Actions","breadcrumbs":[{"href":"/es/enterprise-server@3.22/actions","title":"GitHub Actions"},{"href":"/es/enterprise-server@3.22/actions/how-tos","title":"Procedimientos"},{"href":"/es/enterprise-server@3.22/actions/how-tos/troubleshoot-workflows","title":"Solución de problemas de flujos de trabajo"}],"documentType":"article"},"body":"# Flujos de trabajo de solución de problemas\n\nPuede usar las herramientas de GitHub Actions para depurar los flujos de trabajo.\n\n> \\[!NOTE]\n> Actualmente los ejecutores hospedados por GitHub Enterprise Server no se admiten en GitHub.\n\n## Sugerencias iniciales para la solución de problemas\n\nHay varias maneras de solucionar errores en las ejecuciones de flujo de trabajo.\n\n### Uso de registros de ejecución de flujo de trabajo\n\nCada ejecución de flujo de trabajo genera bitácoras de actividad que puedes ver, buscar y descargar. Para más información, consulta [Uso de registros de flujo de trabajo](/es/enterprise-server@3.22/actions/how-tos/monitor-workflows/use-workflow-run-logs).\n\n### Habilitación del registro de depuración\n\nSi 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. Para más información, consulta [Habilitación del registro de depuración](/es/enterprise-server@3.22/actions/how-tos/monitor-workflows/enable-debug-logging).\n\nSi el flujo de trabajo usa herramientas o acciones específicas, habilitar sus opciones de registro detallado o depuración puede ayudar a generar resultados más detallados para solucionar problemas.\nPor ejemplo, puedes usar `npm install --verbose` para npm o `GIT_TRACE=1 GIT_CURL_VERBOSE=1 git ...` para Git.\n\n## Solucionar problemas de desencadenadores de flujo de trabajo\n\nEn primer lugar, asegúrese de que el flujo de trabajo no se ha deshabilitado manualmente, consulte [Deshabilitación y habilitación de un flujo de trabajo](/es/enterprise-server@3.22/actions/how-tos/manage-workflow-runs/disable-and-enable-workflows). Un flujo de trabajo deshabilitado no responde a sus desencadenadores.\n\nPuedes revisar el campo `on:` del flujo de trabajo para comprender lo que se espera que desencadene. Para más información, consulta [Activar un flujo de trabajo](/es/enterprise-server@3.22/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow).\n\nPara ver la lista completa de eventos disponibles, consulta [Eventos que desencadenan flujos de trabajo](/es/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows).\n\n### Desencadenar condiciones de evento\n\nAlgunos eventos de desencadenamiento solo se ejecutan desde la rama predeterminada (es decir, `issues`, `schedule`). Las versiones del archivo de flujo de trabajo que existen fuera de la rama predeterminada no se desencadenarán en estos eventos.\n\nLos flujos de trabajo no se ejecutarán en la actividad `pull_request` si la solicitud de incorporación de cambios tiene un conflicto de combinación.\n\nLos flujos de trabajo que, de lo contrario, se desencadenarían en la actividad `push` o `pull_request` se omitirán si el mensaje de confirmación contiene una anotación de omisión. Para más información, consulta [Saltarse las ejecuciones de código](/es/enterprise-server@3.22/actions/how-tos/manage-workflow-runs/skip-workflow-runs).\n\n### Flujos de trabajo programados que se ejecutan en momentos inesperados\n\nLos eventos programados pueden retrasarse durante periodos de alta carga de GitHub Actions ejecuciones de flujos de trabajo.\n\nLos tiempos de carga alta incluyen el inicio de cada hora. Si la carga es lo suficientemente alta, es posible que se quiten algunos trabajos en cola. Para aminorar la posibilidad de los retrasos, programa tu flujo de trabajo para que se ejecute en una porción diferente de la hora. Para más información, consulta [Eventos que desencadenan flujos de trabajo](/es/enterprise-server@3.22/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule).\n\n### Límites de filtrado y diferencias\n\nLos eventos específicos permiten filtrar por rama, etiqueta o rutas de acceso que puedes personalizar. La creación de la ejecución del flujo de trabajo se omitirá si se aplican las condiciones de filtro para filtrar el flujo de trabajo.\n\nPuedes usar caracteres especiales con filtros. Para más información, consulta [Sintaxis del flujo de trabajo para Acciones de GitHub](/es/enterprise-server@3.22/actions/reference/workflows-and-actions/workflow-syntax#filter-pattern-cheat-sheet).\n\nPara el filtrado de rutas de acceso, la evaluación de diferencias se limita a los primeros 300 archivos. Si hay archivos que cambiaron y no se correspondieron en los primeros 300 archivos que devuelve el filtro, el flujo de trabajo no se ejecutará. Para más información, consulta [Sintaxis del flujo de trabajo para Acciones de GitHub](/es/enterprise-server@3.22/actions/reference/workflows-and-actions/workflow-syntax#git-diff-comparisons).\n\n## Solución de problemas de ejecución de flujo de trabajo\n\nLa ejecución del flujo de trabajo implica cualquier problema detectado después de que se haya desencadenado el flujo de trabajo y se haya creado una ejecución de flujo de trabajo.\n\n### Cancelar flujos de trabajo\n\nSi la cancelación estándar mediante la interfaz de usuario de [UI](/es/enterprise-server@3.22/actions/reference/workflows-and-actions/workflow-cancellation) o [API](/es/enterprise-server@3.22/rest/actions/workflow-runs?apiVersion=2022-11-28#cancel-a-workflow-run) no procesa según lo previsto, puede haber una instrucción condicional configurada para los trabajos de flujo de trabajo en ejecución que hacen que no se cancele.\n\nEn estos casos, puedes sacar provecho de la API para forzar la cancelación de la ejecución. Para más información, consulta [Puntos de conexión de API de REST para ejecuciones de flujo de trabajo](/es/enterprise-server@3.22/rest/actions/workflow-runs?apiVersion=2022-11-28#force-cancel-a-workflow-run).\n\nUna causa común puede ser el uso de la `always()`función de comprobación de estado [](/es/enterprise-server@3.22/actions/reference/workflows-and-actions/expressions#status-check-functions), que devuelve `true`, incluso en caso de cancelación. Una alternativa es usar el inverso de la función `cancelled()`, `${{ !cancelled() }}`.\n\nPara más información, consulta [Utilizar condiciones para controlar la ejecución de jobs](/es/enterprise-server@3.22/actions/how-tos/write-workflows/choose-when-workflows-run/control-jobs-with-conditions) y [Cancelar una ejecución de flujo de trabajo](/es/enterprise-server@3.22/actions/how-tos/manage-workflow-runs/cancel-a-workflow-run).\n\n## Solucionar problemas de ejecutores\n\n### Definir etiquetas de ejecutor\n\nGitHubLos ejecutores hospedados aprovechan [las etiquetas preestablecidas](/es/enterprise-server@3.22/actions/reference/runners/github-hosted-runners) mantenidas a través del repositorio [`actions/runner-images`](https://github.com/actions/runner-images?tab=readme-ov-file#available-images).\n\nSe recomienda usar nombres de etiqueta únicos para ejecutores más grandes y autohospedados. Si una etiqueta coincide con cualquiera de las etiquetas preestablecidas existentes, puede haber problemas de asignación de ejecutor en los que no hay ninguna garantía sobre la opción del ejecutor coincidente en la que se ejecutará el trabajo.\n\n### Ejecutores autohospedados\n\nSi utilizas ejecutores auto-hospedados, puedes ver su actividad y diagnosticar problemas comunes.\n\nPara más información, consulta [Supervisión y solución de problemas de ejecutores autohospedados](/es/enterprise-server@3.22/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot).\n\n## Sugerencias de solución de problemas de redes\n\nNuestro soporte técnico se limita a los problemas de red que implican lo siguiente:\n\n* Tus redes\n* Redes externas\n* Sistemas de terceros\n* Conectividad a Internet general\n\nPara ver el estado en tiempo real de la plataforma de GitHub, consulte [GitHub Estado](https://githubstatus.com/).\n\nPara otros problemas relacionados con la red, revisa la configuración de red de tu organización y comprueba el estado de los servicios de terceros a los que accedes. Si los problemas persisten, considera la posibilidad de ponerte en contacto con los administradores de red para obtener más ayuda.\n\nSi no está seguro sobre el problema, póngase en contacto con Soporte de GitHub. Para más información sobre cómo ponerse en contacto con el soporte técnico, consulta [Contactar al Soporte de GitHub](/es/enterprise-server@3.22/support/contacting-github-support).\n\n### DNS\n\nSe pueden producir incidencias en la configuración del Sistema de nombres de dominio (DNS), la resolución o problemas de solucionadores. Te recomendamos revisar los registros disponibles, la documentación del proveedor o consultar con los administradores para obtener ayuda adicional.\n\n### Firewalls\n\nLos firewalls pueden bloquear las actividades. Si esto ocurre, es posible que quieras revisar los registros disponibles, la documentación del proveedor o consultar con los administradores para obtener ayuda adicional.\n\n### Proxies\n\nSe podría producir un error en las actividades al usar un proxy para las comunicaciones. Es recomendable revisar los registros disponibles, la documentación del proveedor o consultar con los administradores para obtener ayuda adicional.\n\nConsulta [Uso de servidores proxy con un ejecutor](/es/enterprise-server@3.22/actions/how-tos/manage-runners/use-proxy-servers) para obtener información sobre cómo configurar la aplicación del ejecutor para que use un proxy.\n\n### Subredes\n\nEs posible encontrar problemas con subredes en uso o superposiciones con una red existente, como dentro del proveedor de nube virtual o las redes de Docker. En esos casos, se recomienda revisar la topología de red y las subredes en uso.\n\n### Certificados\n\nSe pueden producir problemas de cadenas de certificados autofirmados o personalizados, y almacenes de certificados. Puedes comprobar que un certificado en uso no ha expirado y que actualmente es de confianza. Los certificados se pueden inspeccionar con `curl` o herramientas similares. También puedes revisar los registros disponibles, la documentación del proveedor o consultar con los administradores para obtener ayuda adicional.\n\n### Listas de IP\n\nLas listas de direcciones IP permitidas o denegadas pueden interrumpir las comunicaciones esperadas. Si hay un problema, deberías revisar los registros disponibles, la documentación del proveedor o consultar con los administradores para obtener ayuda adicional.\n\n### Sistemas operativos y aplicaciones de software\n\nAdemás de los cortafuegos o servidores proxy, las personalizaciones realizadas en los ejecutores alojados en GitHub, como la instalación de paquetes de software adicionales, pueden provocar interrupciones en la comunicación. Para obtener información sobre las opciones de personalización disponibles, consulta [Personalización de runners hospedados en GitHub](/es/enterprise-server@3.22/actions/how-tos/manage-runners/github-hosted-runners/customize-runners).\n\n* Para los ejecutores autohospedados, obtén más información sobre los puntos de conexión necesarios en [Referencia de ejecutores autohospedados](/es/enterprise-server@3.22/actions/reference/runners/self-hosted-runners).\n\n* Para obtener ayuda a fin de configurar WireGuard, consulta [Uso de WireGuard para crear una superposición de red](/es/enterprise-server@3.22/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-wireguard).\n\n* Para más información sobre la configuración de OpenID Connect (OIDC), consulta [Usar una puerta de enlace de API con OIDC](/es/enterprise-server@3.22/actions/how-tos/manage-runners/github-hosted-runners/connect-to-a-private-network/connect-with-oidc)."}