跳至主要内容

与 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 运行器控制器

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

有关 Actions 运行器控制器支持范围的更多信息,请参阅“关于 Actions 运行器控制器的支持”。

CodeQL 和 GitHub Actions

如果您请求有关 CodeQL 分析工作流的帮助,GitHub 支持团队可能会请求一份 CodeQL 调试工件的副本。有关 CodeQL 分析工作流的调试工件的更多信息,请参阅“日志不够详细”。

要将调试工件提供给 GitHub 支持团队,请从示例工作流运行中下载 CodeQL 调试工件,并将其作为.zip文件附加到您的工单。有关下载工作流工件的更多信息,请参阅“下载工作流工件”。

如果 CodeQL 调试工件.zip文件太大而无法上传到工单,请告知 GitHub 支持团队,我们将与您一起确定后续步骤。

支持范围

如果您的支持请求超出了我们团队能够帮助您的范围,我们可能会建议您采取后续步骤来解决您在 GitHub 支持团队之外的问题。如果您的请求主要关于以下方面,则您的支持请求可能超出了 GitHub 支持团队的范围:

  • 第三方集成,例如 Jira
  • 企业云导入器(仅在专家指导的迁移中可用)
  • CI/CD,例如 Jenkins
  • 编写脚本
  • 外部身份验证系统的配置,例如 SAML 身份提供商
  • 开源项目
  • 为 CodeQL 编写或调试新的查询
  • 云提供商配置,例如虚拟网络设置、自定义防火墙或代理规则。
  • 容器编排,例如 Kubernetes 设置、网络等。
  • 工作流和数据管理的详细帮助
  • 公开预览功能。GitHub 支持团队不提供公开预览功能的支持。

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

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