我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

启用调试日志

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

GitHub Actions 可用于 GitHub Free、GitHub Pro、组织的 GitHub Free、GitHub Team、GitHub Enterprise Cloud 和 GitHub One。 GitHub Actions 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。 更多信息请参阅“GitHub 的产品”。

本文内容

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

  • 要为用户帐户仓库创建密码,您必须是仓库所有者。 要为组织仓库创建密码,您必须具有管理员访问权限。
  • 要在组织级别创建密码,必须具有管理员访问权限。
  • 要使用 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. 设置密码后,步骤日志中会显示更多调试事件。 更多信息请参阅“查看日志以诊断故障”

此文档对您有帮助吗?

Privacy policy

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。