为 GitHub Copilot 代码评审配置运行器

为 GitHub 使用自托管运行器或更大规模的 Copilot 代码评审 托管运行器。

在本文中

关于 GitHub Actions 在代码评审工具中的使用

处于这种情况的 Copilot 代码评审 使用 GitHub Actions 运行代理能力，包括完整的项目上下文收集和公开预览中的所有功能。 默认情况下，Copilot 代码评审 使用 GitHub 托管运行器。 对私有仓库进行评审时，所消耗的 Actions 分钟数将从您的帐户或组织现有计划所含的配额中扣除；超出所含分钟数的任何用量将按标准 GitHub Actions 费率计费。

如果您的组织禁用了托管 GitHub 运行程序，则代理功能将不可用。 在这种情况下，代码评审将回退为更有限的评审。 组织可以使用自托管运行器。

还可以升级到更大的 GitHub 托管运行器以获得更好的性能。

为代码审查配置自托管运行器

使用带 ARC（Actions Runner Controller）的自托管 Copilot 代码评审 运行器运行 GitHub Actions。 必须先在环境中设置 ARC 托管的规模集。 有关 ARC 的详细信息，请参阅 Actions Runner Controller。

警告

ARC 是唯一正式支持自托管 Copilot 代码评审 的解决方案。 请勿使用非 ARC 托管的运行器，出于安全原因。

Copilot 代码评审 仅与 Ubuntu x64 Linux 运行程序兼容。

要为 Copilot 代码评审 配置自托管运行器：

  1. 为 GitHub Actions 运行程序配置网络安全控制，以确保 Copilot 代码评审 对网络或公共 Internet 没有开放访问权限。

    你必须配置防火墙，以允许连接到用于 GitHub Actions 自托管运行器的标准主机，以及以下主机：

    • api.githubcopilot.com
    • uploads.github.com
    • user-images.githubusercontent.com

  2. 在你的 copilot-setup-steps.yml 文件中，将 runs-on 属性设置为 ARC 管理的伸缩集名称。 有关详细信息，请参阅“配置开发环境”。

    # ...

jobs:
  copilot-setup-steps:
    runs-on: arc-scale-set-name
    # ...

升级到更大规模的 GitHub 托管 GitHub Actions 运行器

默认情况下，在 Copilot 代码评审 标准 GitHub Actions 运行程序上运行。 较大的运行程序提供更好的性能（CPU 和内存）、更多的磁盘空间和高级功能，例如Azure专用网络。 请参阅“大型运行程序”。

注意

使用更大的 GitHub 托管运行器按更高的每分钟费率计费。 有关详细信息，请参阅“GitHub Actions计费”。

  1. 为你的组织设置更大型的运行器。 请参阅“管理较大的运行器”。

  2. 如果在 Azure 专用网络中使用更大的运行器，请配置 Azure 专用网络以允许对以下主机的出站访问：

    • api.githubcopilot.com
    • uploads.github.com
    • user-images.githubusercontent.com

  3. 在 copilot-setup-steps.yml 文件中，将 runs-on 属性设置为你想要 Copilot 代码评审 使用的更大运行器的标签。 请参阅“在较大的运行器上运行作业”。

    # ...

jobs:
  copilot-setup-steps:
    runs-on: ubuntu-4-core
    # ...

在组织级配置运行器

组织所有者可以为组织中所有仓库的 Copilot 代码评审 和 Copilot云代理 设置默认运行器类型，并控制各个仓库是否可以覆盖此默认设置。

注意

组织级运行器类型同时适用于 Copilot 代码评审 和 Copilot云代理。 除非禁用“允许存储库自定义运行器类型”****，否则存储库仍可使用 copilot-setup-steps.yml 覆盖组织的默认设置。 有关详细信息，请参阅“在组织中为 GitHub Copilot 云智能体配置运行器”。

如果你的组织要求所有代码审查和 云代理 任务都在特定的运行器上运行，那么这会很有用；例如，可以使用更大的运行器来提高性能，或使用能够访问内部资源的自托管运行器。

  1. 在 GitHub 的右上角，单击个人资料图片，然后单击“ Your organizations”****。

  2. 单击以选择一个组织。

  3. 在组织名称下，单击 “Settings”****。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  4. 在边栏中的“代码、规划和自动化”下，单击 Copilot，然后单击“ 运行程序类型”。

  5. 在“运行程序类型配置”旁边，单击 。

  6. 在“编辑运行程序类型”对话框中，选择要在组织中默认使用的运行程序类型，然后单击“ 保存运行程序”选择。

    • 标准GitHub运行器：Copilot 代码评审和Copilot云代理将使用标准的GitHub托管运行器。
    • 带标签的运行器：Copilot 代码评审 和 Copilot云代理 将使用与您指定的标签匹配的运行器。

  7. （可选）若要阻止单个存储库使用其 copilot-setup-steps.yml 文件替代组织级运行程序配置，请禁用 “允许存储库”自定义运行程序类型。