58 lines
1.8 KiB
Markdown
58 lines
1.8 KiB
Markdown
# 🎯 Gitea Runner Template
|
||
|
||
[](https://www.docker.com/)
|
||
|
||
> 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 预设为例：
|
||
|
||
```bash
|
||
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](./DEPLOYMENT.md)。
|
||
|
||
## 📂 你要找什么
|
||
|
||
- 部署或运维 runner：看 [DEPLOYMENT.md](./DEPLOYMENT.md)
|
||
- 使用或定制 workflow：看 [WORKFLOW.md](./WORKFLOW.md)
|
||
- 查看当前示例 workflow：直接看 `.gitea/workflows/`
|
||
|
||
## 🗂️ 仓库结构
|
||
|
||
```txt
|
||
.
|
||
├── .gitea/
|
||
│ ├── ci/bootstrap_workspace.sh
|
||
│ └── workflows/
|
||
├── docker-runner/
|
||
│ ├── common/
|
||
│ └── presets/
|
||
├── DEPLOYMENT.md
|
||
└── WORKFLOW.md
|
||
```
|