跳至主要内容

使用 GitHub 操作支持

了解 GitHub 支持如何协助使用 GitHub 操作

你可以联系 GitHub 支持以获得有关 GitHub 操作的帮助。

提供诊断和故障排除信息

GitHub 支持无法查看私有和内部存储库的内容,因此 GitHub 支持可能会要求提供其他信息以了解你的询问的完整背景并重现任何意外行为。当你最初向 GitHub 支持提交工单时,你可以提供此信息以加快解决你的询问。

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

  • 工作流运行的 URL。

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

  • 附加到工单中的工作流 .yml 文件作为 .txt 文件。有关工作流的更多信息,请参阅“关于工作流”。

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

  • 如果您在自托管运行器上运行此工作流,则自托管运行器日志位于运行器内的 _diag 文件夹下。有关自托管运行器的详细信息,请参阅“监视和故障排除自托管运行器”。

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

注意:通过将文件的扩展名更改为 .txt.zip,将文件附加到您的支持工单。如果您在工单中内联包含诸如日志或工作流文件片段之类的文本数据,请确保它们以 Markdown 代码块的正确格式进行格式化。有关 Markdown 正确格式化的详细信息,请参阅“基本的编写和格式化语法”。

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

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

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

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

Actions 运行器控制器

如果您使用 Actions Runner Controller (ARC),GitHub 支持可能会要求您提交控制器、侦听器和 Runner 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
  • 企业云导入器(仅适用于专家指导的迁移)
  • CI/CD,如 Jenkins
  • 编写脚本
  • 外部认证系统配置,如 SAML 身份提供商
  • 开源项目
  • 为 CodeQL 编写或调试新查询
  • 云提供商配置,如虚拟网络设置、自定义防火墙或代理规则。
  • 容器编排,如 Kubernetes 设置、网络等。
  • Beta 功能。GitHub 支持不涵盖对 Beta 功能的支持。

如果您不确定问题是否超出范围,请提交工单,我们很乐意帮助您确定最佳处理方法。