actions-template/README.md

🎯 Gitea Runner Template

🚀 Gitea Runner Docker 部署模板 + Actions Workflow 示例 + 文档规范

📖 项目简介

这是一个完整的 Gitea Runner 模板项目，提供：

• 🐳 Docker 部署方案：开箱即用的 Runner 容器化部署
• 📝 Workflow 示例：自动化 CHANGELOG 和 Release 工作流
• 📚 文档规范：统一的文档格式和版本管理规范
• 🔧 配置指南：详细的配置说明和最佳实践

⚙️ 当前默认行为

• 新注册的 runner 默认 capacity=4
• 大仓库会缓存到 /data/git-mirrors/<owner>/<repo>.git
• 每个 workflow job 使用独立临时目录 /home/workspace/jobs/<owner>/<repo>/<job-identity>/repo
• job 结束后会自动清理临时工作目录，mirror 缓存保留在 runner-data/
• 每个 preset 通过 .env.example 提供公司默认实例值，部署时复制为 .env 即可

📂 文档导航

🚀 Runner

DEPLOYMENT.md

Gitea Runner Docker 部署完整教程

包含内容：

• 📦 标准版 vs Buildx 多架构版选择
• 📝 Dockerfile 和 docker-compose.yml 配置
• 🔧 安装、注册、管理脚本详解
• ⚙️ 完整的部署流程
• ❓ 常见问题和故障排除

👉 完整的 Runner 部署教程，从零开始搭建

---

📋 Workflow

Gitea Actions 自动化工作流示例

包含内容：

• 💡 工作流配置说明
• 🔧 如何使用和定制
• 🔄 案例：changelog_and_release.yml - 自动更新 CHANGELOG 和自动创建 Release

👉 实用的 Actions 工作流，可直接复制使用

---