Terraform Provider F5xc

🚀 自托管GitHub Actions运行器（容器化）

本项目可让你在Docker容器中运行GitHub Actions运行器，且所有依赖项均已预先安装。它为你提供了一个便捷的方式来执行GitHub Actions任务，无需手动安装和配置复杂的依赖环境。

✨ 主要特性

• 包含GitHub Actions运行器2.321.0版本。
• 预装Go 1.23.3、Terraform 1.9.8等开发工具。
• 集成GitHub CLI（gh），方便与GitHub交互。
• 具备curl、jq、git等常用工具。

📦 安装指南

1. 配置环境

cd .github-runner-docker
cp .env.example .env

编辑 .env 文件并填入对应的值：

• GITHUB_REPOSITORY - 你的仓库（例如：owner/repo）
• GITHUB_TOKEN - 具有 repo 权限的个人访问令牌
• F5XC_API_URL - F5 XC API的URL
• F5XC_API_TOKEN - F5 XC API令牌

2. 构建并启动

docker-compose up -d --build

3. 查看日志

docker-compose logs -f

4. 停止运行器

docker-compose down

运行器在正常关闭时会自动从GitHub注销。

📚 详细文档

获取GitHub令牌

1. 访问 GitHub设置 → 令牌
2. 生成新的经典令牌
3. 选择权限范围：repo（对私有仓库的完全控制）
4. 复制并保存令牌

获取F5 XC API令牌

1. 登录F5 XC控制台
2. 进入管理 → 个人管理 → 凭证
3. 添加凭证 → API令牌
4. 复制并保存令牌

架构支持

该容器支持 amd64 和 arm64 架构。Docker在构建时会自动选择正确的二进制文件。

资源要求

• CPU：建议2核
• 内存：建议4GB
• 磁盘：容器和工作目录共需10GB

🔧 技术细节

故障排除

运行器无法注册

1. 检查 GITHUB_TOKEN 是否具有 repo 权限。
2. 确认你对仓库有管理员权限。
3. 查看日志：docker-compose logs

测试因缺少工具而失败

容器中已包含Go、Terraform和常用工具。若缺少某个工具：

1. 将其添加到Dockerfile中。
2. 重新构建：docker-compose up -d --build

运行器显示离线

1. 检查容器是否正在运行：docker ps
2. 查看日志中的错误信息：docker-compose logs
3. 重启：docker-compose restart

高级配置

自定义标签

RUNNER_LABELS=self-hosted,Linux,X64,production

多运行器

创建多个 .env 文件和组合文件以进行扩展：

# runner1.env, runner2.env等
docker-compose -f docker-compose.yml --env-file runner1.env up -d

持久缓存

工作目录会保存在Docker卷（f5xc-runner-work）中，以便在运行之间缓存Go模块和构建工件。