用于本地部署的自托管运行器

欢迎了解自托管运行器！这些强大的工具可以让您在自己的机器上运行 GitHub 操作工作流。

您不必使用 GitHub 托管的云运行器，而是可以使用自己的硬件、操作系统和网络环境来执行 CI/CD 作业。

虽然 GitHub 托管的运行器使用方便，但自托管运行器还具有独特的优势：

• 特定硬件：使用自定义硬件，例如 GPU 或特定的 CPU 架构。
• 网络访问：直接连接到私有网络和资源（数据库、内部服务）。
• 安全性：将敏感的构建环境保留在您自己的受控基础设施中。
• 成本优化：利用现有基础设施，可能降低高用量场景下的成本。

要设置自托管运行器，您的计算机需要满足一些基本要求：

• 操作系统：支持 Linux、Windows 或 macOS。
• 网络访问：运行器计算机必须能够与 GitHub.com（或 GitHub Enterprise Server）通信。
• 资源：具备足够的 CPU、RAM 和磁盘空间来处理工作流任务。
• 软件：工作流所需的任何工具或 SDK 都必须安装在运行器上。

设置自托管运行器包含几个关键步骤。这就像将您的计算机准备为 GitHub 操作的专用工作节点：

1. 从 GitHub 生成唯一的注册令牌。
2. 将运行器应用程序下载并解压到您的计算机上。
3. 使用 GitHub 仓库或组织 URL 以及令牌配置运行器。
4. 启动运行器应用程序以监听任务。

首先，您需要告知 GitHub 您正在设置新的运行器。这需要一个唯一令牌。

在 GitHub.com 上打开您的仓库或组织设置：

• 对于仓库：Settings > Actions > Runners > New self-hosted runner
• 对于组织：Settings > Actions > Runners > New self-hosted runner

按照提示生成令牌。此令牌仅用于注册。

接下来，将运行器应用程序下载到您选择的计算机上。GitHub 界面会为您的 OS 提供具体命令。

例如，在 Linux 计算机上，您可能会使用：

解压后，您需要配置运行器。这会将运行器连接到您的 GitHub 仓库或组织，并允许您设置标签。

运行 config.sh（Linux/macOS）或 config.cmd（Windows）脚本。您需要提供 GitHub URL 和之前生成的令牌。

配置完成后，您就可以启动运行器应用程序。随后，它会连接到 GitHub 并等待任务。

只需运行 ./run.sh（Linux/macOS）或 run.cmd（Windows）即可。在生产环境中，建议将运行器安装为服务，使其自动启动。

要使用自托管运行器，请在工作流 YAML 文件中使用 runs-on 关键字指定它。您可以使用 self-hosted，也可以使用配置期间分配的特定标签。

自托管运行器相比 GitHub 托管的运行器具有独特优势。使用自托管运行器的主要优势是什么？

您已经了解了自托管运行器！借助它，您可以在自己的基础设施上执行 GitHub 操作工作流，从而掌控硬件、网络访问和安全性。

我们介绍了设置流程：生成令牌、下载应用程序、配置并启动运行器。您还了解了如何在工作流 YAML 文件中使用 runs-on 指定自定义运行器。