# 🎯 Gitea Runner Template

[![Docker](https://img.shields.io/badge/docker-ready-brightgreen.svg)](https://www.docker.com/)

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

## 📖 项目简介

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

- 🐳 **Docker 部署方案**：开箱即用的 Runner 容器化部署
- 📝 **Workflow 示例**：自动化 CHANGELOG、Release 和统计徽章工作流
- 📚 **文档规范**：统一的部署说明与工作流说明
- 🔧 **配置指南**：预设配置、注册流程和运行方式说明

## 📂 文档导航

### 🚀 [DEPLOYMENT.md](./DEPLOYMENT.md)

**Gitea Runner Docker 部署完整教程**

包含内容：

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

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

---

### 📋 [WORKFLOW.md](./WORKFLOW.md)

**Gitea Actions 自动化工作流示例**

包含内容：

- 💡 工作流配置说明
- 🔧 如何使用和定制
- 🧰 案例：`prepare.yml` - 检查并补齐公共工具，集中准备共享 bare 仓库
- 📊 案例：`update_stats_badge.yml` - 在成功的 Prepare 主分支运行后生成统计徽章
- 📦 案例：`changelog_and_release.yml` - 在成功的 Prepare 版本 Tag 运行后生成 CHANGELOG 和 Release
- 🖥️ 案例：`ubuntu_system_info.yml` - 直接触发的独立系统信息任务，可与 Prepare 并行

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

---

仓库相关工作流采用 `Prepare → workflow_run 消费者` 模型；系统信息不读取仓库，因此保持独立触发。详细的共享目录、并发和恢复规则见 [WORKFLOW.md](./WORKFLOW.md)。

具体部署步骤、预设选择、注册流程、升级方式和故障排查请查看 [DEPLOYMENT.md](./DEPLOYMENT.md)。