在现代软件开发中，CI/CD（持续集成/持续交付）已经成为了开发流程中不可或缺的一部分。GitHub 提供了 GitHub Actions 功能，让开发者能够自动化构建、测试和部署代码，而 GitHub Runner 则是实现这一功能的重要组件。本文将详细介绍如何安装和配置 GitHub Runner。
什么是 GitHub Runner？
GitHub Runner 是一个执行 GitHub Actions 的应用程序。它可以在 GitHub 仓库中配置，能够在不同的操作系统上运行工作流。每个运行器都是一个独立的执行环境，可以在其上运行自定义的脚本。
为什么要安装 GitHub Runner？
- 自定义环境：默认的 GitHub Runner 是公共的，有时候你可能需要自定义的环境。
- 更高的资源限制：使用自托管的 Runner，你可以更好地控制资源配置。
- 安全性：对于一些需要更高安全性的项目，自托管的运行器能够让你更好地管理访问权限。
安装 GitHub Runner 的准备工作
在安装 GitHub Runner 之前，需要确保以下条件已满足：
- 操作系统：支持 Windows、macOS 和 Linux 系统。
- GitHub 账号：需要有权限访问目标 GitHub 仓库。
- 网络连接：需要有稳定的网络连接。
安装 GitHub Runner 的步骤
1. 创建一个 GitHub Runner
- 登录你的 GitHub 账号。
- 进入目标项目的页面。
- 点击右上角的 Settings。
- 在左侧菜单中找到 Actions，然后选择 Runners。
- 点击 New self-hosted runner 按钮。
2. 选择操作系统
在选择操作系统时，根据你所使用的环境选择相应的选项。你会看到关于下载和安装 Runner 的指示。
3. 下载 Runner 程序
按照页面的指示下载对应平台的压缩包。
- 对于 Linux，可以使用如下命令： bash curl -o actions-runner-linux-x64-2.285.0.tar.gz -L https://github.com/actions/runner/releases/download/v2.285.0/actions-runner-linux-x64-2.285.0.tar.gz
4. 解压缩文件
解压下载的文件： bash tar xzf actions-runner-linux-x64-2.285.0.tar.gz
5. 配置 Runner
运行配置脚本并按照指示输入你的 GitHub Token 和仓库信息： bash ./config.sh –url https://github.com/你的用户名/你的仓库 –token YOUR_TOKEN
6. 启动 Runner
完成配置后，可以使用以下命令启动 Runner： bash ./run.sh
7. 验证 Runner 状态
返回到 GitHub 页面，查看运行器是否已经成功添加。你应该可以看到它在线并可用。
常见问题解答（FAQ）
Q1: 如何获取 GitHub Token？
要获取 GitHub Token，你需要：
- 登录 GitHub。
- 前往 Settings > Developer settings > Personal access tokens。
- 点击 Generate new token，选择合适的权限，然后生成。
Q2: 自托管 Runner 可以用于哪些类型的工作流？
自托管 Runner 可以用于几乎所有类型的工作流，包括构建、测试和部署等，具体取决于你配置的工作流定义。
Q3: 自托管 Runner 的系统要求是什么？
- 支持的操作系统包括 Linux、Windows 和 macOS。
- 需要有支持的处理器架构（如 x64、ARM64）。
Q4: 如何停止或删除一个 Runner？
你可以在 GitHub 的 Runner 页面，选择要停止或删除的运行器，然后选择相应的操作即可。
Q5: 安装后如何进行故障排除？
如果 Runner 运行不正常，可以检查以下内容：
- 查看 Runner 日志文件，查找错误信息。
- 确保网络连接稳定。
- 检查 GitHub 的服务状态，确保没有服务中断。
结论
安装和配置 GitHub Runner 是自动化开发流程的关键一步。通过自托管运行器，你可以获得更高的灵活性和控制能力，提升你的开发效率。如果你在安装过程中遇到问题，可以参考本指南进行故障排除或访问官方文档获取更多帮助。
