actions-template/README.md

🎯 Gitea Runner Template

Gitea Runner Docker 部署模板，附带可直接复用的 Actions workflow 示例。

📖 这个仓库提供什么

• docker-runner/presets/：可直接部署的 runner 预设
• docker-runner/common/：安装、注册、升级、管理脚本
• .gitea/workflows/：可复制的 workflow 示例
• .gitea/ci/bootstrap_workspace.sh：workflow 工作区自举脚本

⚙️ 当前默认行为

• 新注册的 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

🚀 快速开始

以标准 Ubuntu 22.04 预设为例：

cd docker-runner/presets/standard-ubuntu-22
cp .env.example .env
docker compose build
docker compose up -d
docker compose exec gitea-runner /data/setup.sh
docker compose exec gitea-runner /data/register.sh

开始前至少需要在 .env 中填好 GITEA_TOKEN，必要时调整 GITEA_INSTANCE。

完整部署步骤、Buildx 版本选择、升级和故障排查见 DEPLOYMENT.md。

📂 你要找什么

• 部署或运维 runner：看 DEPLOYMENT.md
• 使用或定制 workflow：看 WORKFLOW.md
• 查看当前示例 workflow：直接看 .gitea/workflows/

🗂️ 仓库结构

.
├── .gitea/
│   ├── ci/bootstrap_workspace.sh
│   └── workflows/
├── docker-runner/
│   ├── common/
│   └── presets/
├── DEPLOYMENT.md
└── WORKFLOW.md