# 从 GitHub 支持部门获取有关 GitHub Actions 的帮助

了解 GitHub 支持 如何协助 GitHub Actions

可以[联系 GitHub 支持](/zh/support/contacting-github-support) 以协助 GitHub Actions。

## 提供诊断和疑难解答信息

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

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

* 工作流运行的 URL。

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

* 作为 `.yml` 文件附加到票证的工作流 `.txt` 文件。 有关工作流的详细信息，请参阅 [工作流](/zh/actions/using-workflows/about-workflows#about-workflows)。
* 示例工作流运行失败的工作流运行日志副本。 有关工作流运行日志的详细信息，请参阅 [使用工作流运行日志](/zh/actions/monitoring-and-troubleshooting-workflows/using-workflow-run-logs#downloading-logs)。
* 如果在自托管运行器、自托管运行器日志上运行此工作流（可在运行器中的 `_diag` 文件夹下找到）。 有关自托管运行程序的详细信息，请参阅“[对自托管运行程序进行监视和故障排除](/zh/actions/hosting-your-own-runners/managing-self-hosted-runners/monitoring-and-troubleshooting-self-hosted-runners#reviewing-the-self-hosted-runner-application-log-files)”。

  自承载运行程序日志文件名称的格式如下： `Runner_YYYY####-xxxxxx-utc.log` 和 `Worker_YYYY####-xxxxxx-utc.log`。

> \[!NOTE]
> 通过将文件的扩展名更改为 `.txt` 或 `.zip` 来将文件附加到支持工单。 如果在票证中包含文本数据（例如，日志或工作流文件片段），请确保它们的格式正确设置为 Markdown 代码块。 有关正确的 Markdown 格式的详细信息，请参阅 [基本写作和格式语法](/zh/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#quoting-code)。
>
> 如果你提供的信息由于不正确的 Markdown 语法导致格式丢失而无法读取，则 GitHub 支持 可能会请求以附件或使用正确的 Markdown 格式重新提交信息。

> \[!WARNING]
> 确保提供给 GitHub 支持 的所有文件和文本都经过了正确编辑，以删除令牌和其他机密等敏感信息。

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

GitHub 支持 可以从临时运行器请求运行器应用程序日志文件。 GitHub 需要并建议你实现一种机制，以转发和保留来自自托管临时运行器的运行器应用程序日志文件。 有关运行器应用程序日志文件和自托管运行器故障排除的详细信息，请参阅 [对自托管运行程序进行监视和故障排除](/zh/actions/hosting-your-own-runners/managing-self-hosted-runners/monitoring-and-troubleshooting-self-hosted-runners#reviewing-the-self-hosted-runner-application-log-files)。

### Actions Runner Controller

如果使用 Actions Runner Controller (ARC)，则 GitHub 支持 可能会要求你提交控制器、侦听器和运行器 Pod 的完整日志。 有关收集 Actions Runner Controller 的日志的详细信息，请参阅 [排查 Actions Runner Controller 的错误](/zh/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/troubleshooting-actions-runner-controller-errors#checking-the-logs-of-the-controller-and-runner-set-listener)。

有关 Actions Runner Controller 的支持范围的详细信息，请参阅 [对 Actions Runner Controller 的支持](/zh/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-support-for-actions-runner-controller)。

### CodeQL 和 GitHub Actions

如果要请求有关 CodeQL 分析工作流程 的帮助，则 GitHub 支持 可能会请求 CodeQL 调试项目的副本。 有关 CodeQL 分析工作流程 的调试项目的详细信息，请参阅 [日志不够详细](/zh/code-security/code-scanning/troubleshooting-code-scanning/logs-not-detailed-enough#creating-codeql-debugging-artifacts)。

若要向 GitHub 支持 提供调试项目，请从示例工作流运行下载 CodeQL 调试项目，并将其作为 `.zip` 文件附加到票证。 有关下载工作流项目的详细信息，请参阅 [下载工作流程构件](/zh/actions/managing-workflow-runs/downloading-workflow-artifacts)。

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

## 支持范围

如果你的支持请求超出了我们团队可提供帮助的范围，我们可能会建议你通过 GitHub 支持 之外的后续步骤来解决你的问题。 如果请求主要关于以下问题，则支持请求可能超出 GitHub 支持范围：

* 第三方集成，如 Jira
* CI/CD，例如 Jenkins
* Azure DevOps（请联系 Azure 支持）
* 编写脚本
* 配置外部身份验证系统，例如 SAML 标识提供者
* 开放源代码项目
* 为 CodeQL
  编写或调试新查询
* 云提供商配置，如虚拟网络设置、自定义防火墙或代理规则
* 容器编排，例如 Kubernetes 配置，或网络配置
* 有关工作流和数据管理的详细帮助
* 全面支持在 GitHub Actions 自定义映像上进行自定义和工具安装
* 预览功能。
  公共预览、 个人预览版和 技术预览版 功能已脱离 GitHub 支持范围。
* GitHub Copilot 建议
* ```
            GitHub Copilot 消耗问题。 
  ```

GitHub 支持 不会审计或细分 Copilot 的使用量。 支持团队可以解释计费模型，并指引您查看可用的用量报告文档，但无法确定为什么用量看起来很高，或者为什么套餐内包含的用量比预期更早用尽。

* 按流量计费的说明。
  GitHub 支持 不解释按流量计费 GitHub 产品的使用情况报告或支出趋势，也不基于该数据提供建议。 有关详细信息，请参阅“[计费周期](/zh/billing/concepts/billing-cycles)”。

GitHub Copilot 提供由 AI 支持的代码建议和回复。 根据我们的法律条款，你对自己的代码负全部责任，包括选择采用的任何建议。 响应的质量、准确性、相关性或功能 Copilot可能并不总是满足预期，并可能发生错误。 决定是否使用 Copilot 的建议，GitHub强烈建议实施合理的政策和做法，以防止以违反他人权利的方式使用任何建议。 这包括，但不限于使用可用的 Copilot筛选功能。

Copilot生成的建议和输出不在支持范围内。 GitHub支持无法保证Copilot响应的正确性或适用性，并且不对生成的结果负责。 如果你对特定建议有疑虑，请查看提供的所有链接和信息，以确保准确性和符合你的要求。 有关详细信息，请参阅[GitHub Copilot](/zh/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)[有关使用Copilot](/zh/copilot/get-started/best-practices)的条款和最佳做法。

如果您需要超出支持范围的主题协助、指导式咨询、研讨会或团队培训，请咨询[GitHub专家服务](https://github.com/services/)，其提供专业服务，帮助您优化对我们平台的使用。

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