我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

添加自托管的运行器

您可以将自托管的运行器添加到 GitHub Actions。

本文内容

Did this doc help you?

如果需要支持自托管运行器的操作系统的信息,或通过代理服务器的自托管运行器,请参阅“关于自托管运行器”。

警告: 建议不要将自托管运行器用于公共仓库。

通过创建在工作流程中执行代码的拉取请求,公共仓库的复刻可能会在您的自托管运行器上运行危险代码。

更多信息请参阅“关于自托管运行器”。

添加自托管的运行器到仓库

您可以将自托管的运行器添加到单个仓库中。 要将自托管的运行器添加到用户仓库,您必须是仓库所有者。 对于组织仓库,您必须是组织所有者或拥有该仓库管理员的权限。

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 在仓库名称下,单击 Settings(设置)

    仓库设置按钮

  3. 在左侧边栏中,单击 Actions(操作)

    操作设置

  4. 在“Self-hosted runners(自托管运行器)”下,单击 Add runner(添加运行器)

  5. 选择自托管运行器机器的操作系统和架构。

    选择自托管运行器操作系统

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

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

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

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

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

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

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

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

√ 已连接到 GitHub

2019-10-24 05:45:56Z: 正在监听作业

更多信息请参阅“自托管运行器监控和故障排除”。

添加自托管的运行器到组织

您可以在组织级别添加自托管的运行器,其中它们可被用于处理组织中的多个仓库的作业。 要将自托管的运行器添加到组织,您必须是组织所有者。

  1. 在 GitHub 上,导航到组织的主页面。

  2. 在组织名称下,单击 Settings(设置)

    组织设置按钮

  3. 在左侧边栏中,单击 Actions(操作)

    操作设置

  4. 在“Self-hosted runners(自托管运行器)”下,单击 Add new(新增),然后单击 New runner(新运行器)

  5. 选择自托管运行器机器的操作系统和架构。

    选择自托管运行器操作系统

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

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

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

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

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

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

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

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

√ 已连接到 GitHub

2019-10-24 05:45:56Z: 正在监听作业

更多信息请参阅“自托管运行器监控和故障排除”。

添加自托管运行器到企业

您可以将自托管运行器添加到企业,在该企业中可以将它们分配给多个组织。 然后,组织管理员能够控制哪些仓库可以使用它。

要将自托管的运行器添加到企业帐户,您必须是组织所有者。

  1. 通过访问 https://github.com/enterprises/ENTERPRISE-NAME(将 ENTERPRISE-NAME 替换为您的企业帐户名称)导航至您的企业帐户。

  2. 在企业账户侧边栏中,单击 Policies(政策)

    企业帐户侧边栏中的 Policies(政策)选项卡

  3. Under " Policies", click Actions.

  4. 单击 Self-hosted runners(自托管运行器)选项卡。

  5. 单击 Add new(新增),然后单击 New runner(新运行器)。 新运行器被分配到默认组。 您可以在注册运行器后修改运行器组。 更多信息请参阅“管理对自托管运行器的访问”。

  6. 选择自托管运行器机器的操作系统和架构。

    选择自托管运行器操作系统

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

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

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

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

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

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

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

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

√ 已连接到 GitHub

2019-10-24 05:45:56Z: 正在监听作业

更多信息请参阅“自托管运行器监控和故障排除”。

Did this doc help you?