{"meta":{"title":"添加自托管的运行器","intro":"可以将自托管运行器添加到存储库、组织或企业。","product":"GitHub Actions","breadcrumbs":[{"href":"/zh/actions","title":"GitHub Actions"},{"href":"/zh/actions/how-tos","title":"操作方法"},{"href":"/zh/actions/how-tos/manage-runners","title":"管理运行器"},{"href":"/zh/actions/how-tos/manage-runners/self-hosted-runners","title":"自托管运行程序"},{"href":"/zh/actions/how-tos/manage-runners/self-hosted-runners/add-runners","title":"添加运行器"}],"documentType":"article"},"body":"# 添加自托管的运行器\n\n可以将自托管运行器添加到存储库、组织或企业。\n\n> \\[!WARNING]\n> 建议仅将自托管运行器用于私有仓库。 这是因为，通过创建在工作流中执行代码的拉取请求，公共存储库的分支可能会在自托管运行器计算机上运行危险代码。\n>\n> 有关详细信息，请参阅“[安全使用指南](/zh/actions/reference/security/secure-use)”。\n\n## 先决条件\n\n在添加自托管运行器之前，你应该了解它们是什么以及它们的工作原理。 请参阅“[自托管运行程序](/zh/actions/concepts/runners/self-hosted-runners)”。\n\n此外，必须满足以下要求：\n\n* 必须有权访问将在环境中用作自承载运行器的计算机。\n\n## 添加自托管的运行器到仓库\n\n您可以将自托管的运行器添加到单个仓库中。 要将自托管的运行器添加到用户仓库，您必须是仓库所有者。 对于组织存储库， 必须是组织所有者或具有存储库的管理员访问权限。\n\n有关如何使用 REST API 添加自托管运行器的信息，请参阅“[自托管运行器的 REST API 终结点](/zh/rest/actions/self-hosted-runners)”。\n\n> \\[!NOTE]\n> 所有者可以选择允许哪些存储库创建存储库级自承载运行程序。\n>\n> 有关详细信息，请参阅 [禁用或限制组织的 GitHub Actions](/zh/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#limiting-the-use-of-self-hosted-runners)。\n\n1. 在 GitHub 上，导航到存储库的主页面。\n\n2. 在仓库名称下，单击 “Settings”\\*\\*\\*\\*。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”。\n\n \n\n3. 在左侧边栏中，单击“ Actions”，然后单击“Runners”\\*\\*\\*\\*\\*\\*\\*\\*。\n\n4. 单击“新建自托管运行器”\\*\\*\\*\\*。\n\n5. 选择自托管运行器计算机的操作系统映像和体系结构。\n\n \n\n6. 您将看到有关如何下载运行器应用并将其安装在您的自托管运行器机器上的说明。\n\n 在自托管运行器所在的计算机上打开 Shell，并按所示顺序运行每条 Shell 命令。\n\n > \\[!NOTE]\n > 在 Windows 上，如果要将自托管运行器应用程序安装为服务，必须打开具有管理员权限的 shell。 我们还建议你使用 `C:\\actions-runner` 作为自托管运行器应用程序的目录，以便 Windows 系统帐户可以访问运行器目录。\n\n 这些说明将指导您完成以下任务：\n\n * 下载并解压自托管运行器应用程序。\n * 运行 `config` 脚本以配置自托管运行器应用程序，并将其注册到 GitHub Actions。\n `config` 脚本需要目标 URL 和自动生成的时间限制令牌对请求进行身份验证。 令牌将在一小时后过期。\n * 在 Windows 上，`config` 脚本还会询问你是否想将自托管运行器应用程序安装为服务。 对于 Linux 和 macOS，您可以在完成添加运行器后安装服务。 有关详细信息，请参阅“[将自托管的运行应用程序配置为服务](/zh/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application)”。\n * 运行自托管运行器应用程序，将计算机连接到 GitHub Actions。\n\n### 检查您的自托管运行器是否已成功添加\n\n在完成添加自托管运行器的步骤后，运行器及其状态列在“运行器”下。\n\n必须激活自托管运行器应用程序，运行器才能接受作业。 当运行器应用程序连接到 GitHub 并准备接收作业时，你将在机器的终端上看到以下消息。\n\n```shell\n√ Connected to GitHub\n\n2019-10-24 05:45:56Z: Listening for Jobs\n```\n\n有关详细信息，请参阅“[对自托管运行程序进行监视和故障排除](/zh/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot)”。\n\n## 添加自托管的运行器到组织\n\n您可以在组织级别添加自托管的运行器，其中它们可被用于处理组织中的多个仓库的作业。 若要将自托管运行器添加到组织，你必须是组织所有者。 有关如何使用 REST API 添加自托管运行器的信息，请参阅“[自托管运行器的 REST API 终结点](/zh/rest/actions/self-hosted-runners)”。\n\n1. 在 GitHub 上，导航到组织的主页面。\n2. 在组织名称下，单击 “Settings”\\*\\*\\*\\*。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”\\*\\*\\*\\*\\*\\*\\*\\*。\n\n \n3. 在左侧边栏中，单击“ Actions”，然后单击“Runners”\\*\\*\\*\\*\\*\\*\\*\\*。\n\n1.单击 **“新建运行程序**”，然后单击“ **新建自承载运行程序**”。\n\n1. 选择自托管运行器计算机的操作系统映像和体系结构。\n\n \n\n2. 您将看到有关如何下载运行器应用并将其安装在您的自托管运行器机器上的说明。\n\n 在自托管运行器所在的计算机上打开 Shell，并按所示顺序运行每条 Shell 命令。\n\n > \\[!NOTE]\n > 在 Windows 上，如果要将自托管运行器应用程序安装为服务，必须打开具有管理员权限的 shell。 我们还建议你使用 `C:\\actions-runner` 作为自托管运行器应用程序的目录，以便 Windows 系统帐户可以访问运行器目录。\n\n 这些说明将指导您完成以下任务：\n\n * 下载并解压自托管运行器应用程序。\n * 运行 `config` 脚本以配置自托管运行器应用程序，并将其注册到 GitHub Actions。\n `config` 脚本需要目标 URL 和自动生成的时间限制令牌对请求进行身份验证。 令牌将在一小时后过期。\n * 在 Windows 上，`config` 脚本还会询问你是否想将自托管运行器应用程序安装为服务。 对于 Linux 和 macOS，您可以在完成添加运行器后安装服务。 有关详细信息，请参阅“[将自托管的运行应用程序配置为服务](/zh/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application)”。\n * 运行自托管运行器应用程序，将计算机连接到 GitHub Actions。\n\n### 检查您的自托管运行器是否已成功添加\n\n在完成添加自托管运行器的步骤后，运行器及其状态列在“运行器”下。\n\n必须激活自托管运行器应用程序，运行器才能接受作业。 当运行器应用程序连接到 GitHub 并准备接收作业时，你将在机器的终端上看到以下消息。\n\n```shell\n√ Connected to GitHub\n\n2019-10-24 05:45:56Z: Listening for Jobs\n```\n\n有关详细信息，请参阅“[对自托管运行程序进行监视和故障排除](/zh/actions/how-tos/manage-runners/self-hosted-runners/monitor-and-troubleshoot)”。\n\n> \\[!NOTE]\n> 出于安全原因，公共仓库默认不能使用运行器组中的运行器，但你可以在运行器组的设置中更改此默认设置。 有关详细信息，请参阅“[使用组管理对自托管运行程序的访问](/zh/actions/how-tos/manage-runners/self-hosted-runners/manage-access#changing-which-repositories-can-access-a-runner-group)”。\n\n## 添加自托管运行器到企业\n\n如果您使用 GitHub Enterprise Cloud，您可以将自托管运行器添加到企业中，在其中可将自托管运行器分配给多个组织。 组织所有者可以控制哪些存储库可以使用它。\n有关详细信息，请参阅 [GitHub Enterprise Cloud 文档](/zh/enterprise-cloud@latest/actions/how-tos/manage-runners/self-hosted-runners/add-runners#adding-a-self-hosted-runner-to-an-enterprise)。\n\n## 后续步骤\n\n您可以设置自动化以扩展自托管运行器的数量。 有关详细信息，请参阅“[自托管运行程序参考](/zh/actions/reference/runners/self-hosted-runners#autoscaling)”。"}