Skip to main content

此版本的 GitHub Enterprise 将停止服务 2022-10-12. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

启用调试日志记录

如果工作流程日志没有提供足够的详细信息来诊断工作流程、作业或步骤未按预期工作的原因,您可以启用额外的调试日志。

注意:GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。

这些额外的日志将通过在包含工作流程的仓库中设置密码来启用,因此将应用相同的权限要求:

  • 要为个人帐户存储库创建机密,你必须是存储库所有者。 要为组织存储库创建密码,必须具有 admin 访问权限。
  • 要为个人帐户存储库中的环境创建密码,你必须是存储库所有者。 要为组织存储库中的环境创建机密,必须具有 admin 访问权限。
  • 要在组织级别创建机密,必须具有 admin 访问权限。
  • 要使用 REST API 创建秘密,您必须有对仓库或管理员访问组织的写入权限。 有关详细信息,请参阅“GitHub Actions 机密 API”。

有关设置机密的详细信息,请参阅“创建和使用已加密的机密”。

启用运行程序诊断日志

Runner diagnostic logging provides additional log files that contain information about how a runner is executing a job. 两个额外的日志文件被添加到日志存档中:

  • 运行程序进程日志,其中包含关于如何协调和设置运行程序执行作业的信息。
  • 工作程序进程日志,用于记录作业执行情况。
  1. 若要启用运行器诊断日志记录,请在包含工作流的存储库中进行以下设置:将 ACTIONS_RUNNER_DEBUG 机密设置为 true

  2. 要下载运行程序诊断日志,请下载工作流程运行情况的日志存档。 运行程序诊断日志包含在 runner-diagnostic-logs 文件夹中。 关于下载日志的详细信息,请参阅“下载日志”。

启用步骤调试日志

步骤调试日志增加了作业执行期间和执行之后的作业日志的详细程度。

  1. 要启用步骤调试日志记录,必须在包含工作流的存储库中进行以下设置:将机密 ACTIONS_STEP_DEBUG 设置为 true

  2. 设置密码后,步骤日志中会显示更多调试事件。 有关详细信息,请参阅“查看日志以诊断故障”