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模塊和構建工件。