Skip to main content
我们经常发布文档更新，此页面的翻译可能仍在进行中。有关最新信息，请访问英语文档。
� 

� 

此版本的 GitHub Enterprise 已停止服务 2022-10-12. 即使针对重大安全问题，也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能，请升级到最新版本的 GitHub Enterprise。 如需升级帮助，请联系 GitHub Enterprise 支持。

Adding self-hosted runners

本文内容

You can add a self-hosted runner to a repository, an organization, or an enterprise.

注意：GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。

You can add a self-hosted runner to a repository, an organization, or an enterprise.

If you are an organization or enterprise administrator, you might want to add your self-hosted runners at the organization or enterprise level. This approach makes the runner available to multiple repositories in your organization or enterprise, and also lets you to manage your runners in one place.

For information on supported operating systems for self-hosted runners, or using self-hosted runners with a proxy server, see "About self-hosted runners."

Warning: 建议仅将自托管运行器用于私有仓库。 这是� 为，通过创建在工作流程中执行代� �的拉取请求，仓库的复刻可能会在您的自托管运行器上运行危险代� �。

For more information, see "About self-hosted runners."

Prerequisites

  • 必须为 GitHub Enterprise Server 启用 GitHub Actions。 站点管理员可以为实例启用和配置 GitHub Actions。 有关更多信息，请参阅“GitHub Enterprise Server 的 GitHub Actions 入门”。

  • 必须有权访问将在环境中用作自承载运行器的计算机。

  • The connection between self-hosted runners and GitHub Enterprise Server is over HTTP (port 80) or HTTPS (port 443). To ensure connectivity over HTTPS, configure TLS for your GitHub Enterprise Server instance. For more information, see "Configuring TLS." 有关详细信息，请参阅“关于自承载运行器”。

Adding a self-hosted runner to a repository

You can add self-hosted runners to a single repository. To add a self-hosted runner to a user repository, you must be the repository owner. For an organization repository, you must be an organization owner or have admin access to the repository. For information about how to add a self-hosted runner with the REST API, see "Self-hosted runners."

  1. On your GitHub Enterprise Server instance, navigate to the main page of the repository.

  2. 在存储库名称下，单击 “设置”。 “存储库设置”按钮

  3. In the left sidebar, click Actions.

  4. In the left sidebar, under "Actions", click Runners.

  5. Under "Runners", click Add runner.

  6. 选择自托管运行器计算机的操作系统� 像和体系结构。

  7. 您将看到指示您如何下载运行器应用程序并安装到自托管运行器机器上的说明。

    在自托管运行器机器上打开 shell，并按显示的顺序运行每个 shell 命令。

    注意：在 Windows 上，如果要将自托管运行器应用程序安装为服务，必须打开具有管理员权限的 shell。 我们还建议� 使用 C:\actions-runner 作为自托管运行器应用程序的目录，以便 Windows 系统帐户可以访问运行器目录。

    这些说明将指导您完成以下任务：

    • 下载并提取自托管运行器应用程序。
    • 运行 config 脚本配置自托管运行器应用程序，并将其注册到 GitHub Actions。 config 脚本需要目� � URL 和自动生成的时间限制令牌对请求进行身份验证。
      • 在 Windows 上，config 脚本还会询问� 是否想将自托管运行器应用程序安装为服务。 对于 Linux 和 macOS，您可以在完成添� 运行器后安装服务。 有关详细信息，请参阅“将自托管运行应用程序配置为服务”。
    • 运行自托管运行器应用程序以将机器连接到 GitHub Actions。

检查您的自托管运行器是否已成功添� 

在完成添� 自托管运行器的步骤后，运行器及其状态列在“自托管运行器”下。

必须激活自托管运行器应用程序，运行器才能接受作业。 当运行器应用程序连接到 GitHub Enterprise Server 并准备接收作业时，� 将在机器的终端上看到以下消息。

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

For more information, see "Monitoring and troubleshooting self-hosted runners."

Adding a self-hosted runner to an organization

You can add self-hosted runners at the organization level, where they can be used to process jobs for multiple repositories in an organization. To add a self-hosted runner to an organization, you must be an organization owner. For information about how to add a self-hosted runner with the REST API, see "Self-hosted runners."

  1. On your GitHub Enterprise Server instance, navigate to the main page of the organization.

  2. 在组织名称下，单击“设置”。 组织设置按钮

  3. In the left sidebar, click Actions.

  4. In the left sidebar, under "Actions", click Runners.

  5. Under "Runners", click Add new, then click New runner.

  6. 选择自托管运行器计算机的操作系统� 像和体系结构。

  7. 您将看到指示您如何下载运行器应用程序并安装到自托管运行器机器上的说明。

    在自托管运行器机器上打开 shell，并按显示的顺序运行每个 shell 命令。

    注意：在 Windows 上，如果要将自托管运行器应用程序安装为服务，必须打开具有管理员权限的 shell。 我们还建议� 使用 C:\actions-runner 作为自托管运行器应用程序的目录，以便 Windows 系统帐户可以访问运行器目录。

    这些说明将指导您完成以下任务：

    • 下载并提取自托管运行器应用程序。
    • 运行 config 脚本配置自托管运行器应用程序，并将其注册到 GitHub Actions。 config 脚本需要目� � URL 和自动生成的时间限制令牌对请求进行身份验证。
      • 在 Windows 上，config 脚本还会询问� 是否想将自托管运行器应用程序安装为服务。 对于 Linux 和 macOS，您可以在完成添� 运行器后安装服务。 有关详细信息，请参阅“将自托管运行应用程序配置为服务”。
    • 运行自托管运行器应用程序以将机器连接到 GitHub Actions。

检查您的自托管运行器是否已成功添� 

在完成添� 自托管运行器的步骤后，运行器及其状态列在“自托管运行器”下。

必须激活自托管运行器应用程序，运行器才能接受作业。 当运行器应用程序连接到 GitHub Enterprise Server 并准备接收作业时，� 将在机器的终端上看到以下消息。

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

For more information, see "Monitoring and troubleshooting self-hosted runners."

注意：出于安全原� ，公共存储库默认不能在运行器组中使用运行器，但� 可以在运行器组的设置中覆盖此项。 有关详细信息，请参阅“使用组管理对自托管运行器的访问权限”。

Adding a self-hosted runner to an enterprise

You can add self-hosted runners to an enterprise, where they can be assigned to multiple organizations. The organization admins are then able to control which repositories can use it.

New runners are assigned to the default group. You can modify the runner's group after you've registered the runner. For more information, see "Managing access to self-hosted runners."

To add a self-hosted runner to an enterprise, you must be an enterprise owner.

  1. 在 GitHub Enterprise Server 的右上角，单击� 的个人资料照片，然后单击“企业设置”。 GitHub Enterprise Server 上个人资料照片下拉菜单中的“企业设置”

  2. 在企业边� �中，单击 “策略”。 企业帐户边� �中的“策略”选项卡

  3. 在“ 策略”下，单击“操作”。

  4. 单击“运行器”选项卡。

  5. Click Add new, then click New runner.

  6. 选择自托管运行器计算机的操作系统� 像和体系结构。

  7. 您将看到指示您如何下载运行器应用程序并安装到自托管运行器机器上的说明。

    在自托管运行器机器上打开 shell，并按显示的顺序运行每个 shell 命令。

    注意：在 Windows 上，如果要将自托管运行器应用程序安装为服务，必须打开具有管理员权限的 shell。 我们还建议� 使用 C:\actions-runner 作为自托管运行器应用程序的目录，以便 Windows 系统帐户可以访问运行器目录。

    这些说明将指导您完成以下任务：

    • 下载并提取自托管运行器应用程序。
    • 运行 config 脚本配置自托管运行器应用程序，并将其注册到 GitHub Actions。 config 脚本需要目� � URL 和自动生成的时间限制令牌对请求进行身份验证。
      • 在 Windows 上，config 脚本还会询问� 是否想将自托管运行器应用程序安装为服务。 对于 Linux 和 macOS，您可以在完成添� 运行器后安装服务。 有关详细信息，请参阅“将自托管运行应用程序配置为服务”。
    • 运行自托管运行器应用程序以将机器连接到 GitHub Actions。

检查您的自托管运行器是否已成功添� 

在完成添� 自托管运行器的步骤后，运行器及其状态列在“自托管运行器”下。

必须激活自托管运行器应用程序，运行器才能接受作业。 当运行器应用程序连接到 GitHub Enterprise Server 并准备接收作业时，� 将在机器的终端上看到以下消息。

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

For more information, see "Monitoring and troubleshooting self-hosted runners."

注意：出于安全原� ，公共存储库默认不能在运行器组中使用运行器，但� 可以在运行器组的设置中覆盖此项。 有关详细信息，请参阅“使用组管理对自托管运行器的访问权限”。

Making enterprise runners available to repositories

By default, runners in an enterprise's "Default" self-hosted runner group are available to all organizations in the enterprise, but are not available to all repositories in each organization.

To make an enterprise-level self-hosted runner group available to an organization repository, you might need to change the organization's inherited settings for the runner group to make the runner available to repositories in the organization.

For more information on changing runner group access settings, see "Managing access to self-hosted runners using groups."

Further reading