Skip to main content

使用对 GitHub Actions 的支持

了解 GitHub 支持 如何协助 GitHub Actions

可以联系 GitHub 支持 以协助 GitHub Actions。

提供诊断和疑难解答信息

私有仓库和内部仓库的内容对 GitHub 支持 不可见,因此 GitHub 支持 可能会请求其他信息来了解查询的完整上下文并重现任何意外行为。 当最初向 GitHub 支持 提出票证时,可以通过提供此信息来加快查询的解决速度。

GitHub 支持 将请求的一些信息包括但不限于以下内容:

  • 工作流运行的 URL。

例如:https://github.com/ORG/REPO/actions/runs/0123456789

  • 作为 .txt 文件附加到票证的工作流 .yml 文件。 有关工作流的详细信息,请参阅“关于工作流程”。

  • 示例工作流运行失败的工作流运行日志副本。 有关工作流运行日志的详细信息,请参阅“使用工作流运行日志”。

  • 如果在自托管运行器、自托管运行器日志上运行此工作流(可在运行器中的 _diag 文件夹下找到)。 有关自托管运行程序的详细信息,请参阅“对自托管运行程序进行监视和故障排除”。

    自托管运行器日志文件名称的格式如下:Runner_YYYY####-xxxxxx-utc.logWorker_YYYY####-xxxxxx-utc.log

注意: 通过将文件的扩展名更改为 .txt.zip 来将文件附加到支持票证。 如果在票证中包含文本数据(例如,日志或工作流文件片段),请确保它们的格式正确设置为 Markdown 代码块。 有关正确的 Markdown 格式的详细信息,请参阅“基本撰写和格式语法”。

如果你提供的信息由于不正确的 Markdown 语法导致格式丢失而无法读取,则 GitHub 支持 可能会请求以附件或使用正确的 Markdown 格式重新提交信息。

警告: 确保提供给 GitHub 支持 的所有文件和文本都经过了正确编辑,以删除令牌和其他机密等敏感信息。

临时运行器应用程序日志文件

GitHub 支持 可以从临时运行器请求运行器应用程序日志文件。 GitHub 需要并建议你实现一种机制,以转发和保留来自自托管临时运行器的运行器应用程序日志文件。 有关运行器应用程序日志文件和自托管运行器故障排除的详细信息,请参阅“对自托管运行程序进行监视和故障排除”。

Actions Runner Controller

如果使用 Actions Runner Controller (ARC),则 GitHub 支持 可能会要求你提交控制器、侦听器和运行器 Pod 的完整日志。 有关收集 Actions Runner Controller 的日志的详细信息,请参阅“排查 Actions Runner Controller 的错误”。

有关 Actions Runner Controller 的支持范围的详细信息,请参阅“关于对 Actions Runner Controller 的支持”。

CodeQL 和 GitHub Actions

如果要请求有关 CodeQL 分析工作流程 的帮助,则 GitHub 支持 可能会请求 CodeQL 调试项目的副本。 有关 CodeQL 分析工作流程 的调试项目的详细信息,请参阅“日志不够详细”。

若要向 GitHub 支持 提供调试项目,请从示例工作流运行下载 CodeQL 调试项目,并将其作为 .zip 文件附加到票证。 有关下载工作流项目的详细信息,请参阅“下载工作流程构件”。

如果 CodeQL 调试项目 .zip 文件太大,无法上传到票证,请告知 GitHub 支持,我们将与你一起确定后续步骤。

支持范围

如果您的支持申请超出了我们团队可以帮助您的范围, 我们可能会提出后续措施建议,以便在 GitHub 支持 之外解决您的问题。 您的支持申请如果主要是关于以下方面,可能超出了 GitHub 支持 的范围:

  • 第三方集成,例如 Jira
  • Enterprise Cloud Importer(仅适用于专家引导式迁移)
  • CI/CD,例如 Jenkins
  • 编写脚本
  • 配置外部身份验证系统,例如 SAML 标识提供者
  • 开放源代码项目
  • 写入或调试 CodeQL 的新查询
  • 云提供商配置,如虚拟网络设置、自定义防火墙或代理规则。
  • 容器业务流程协调,例如 Kubernetes 设置、网络等。
  • 工作流和数据管理方面的详细帮助
  • 公共预览版 功能。 对 公共预览版 功能的支持超出 GitHub 支持 的范围。

有关工作流和数据管理的详细帮助,请咨询 GitHub 专家服务,该服务提供专门的支持来帮助优化平台的使用。

如果您不确定问题是否超出范围,请开一个事件单,我们乐意帮助您确定最好的处理方式。