feat(deploy): 添加 Docker Compose 部署方案

新增 Docker Compose 部署方式,包含 Gitea 和 PostgreSQL 容器化配置
更新 README 文档说明两种部署方式
添加 .env 示例文件和 docker-compose.yml 配置文件

Signed-off-by: oierxjn <[email protected]>
This commit is contained in:
2026-04-22 21:46:55 +08:00
parent c338d39ed4
commit e94b5f1398
5 changed files with 243 additions and 5 deletions
+15 -5
View File
@@ -18,13 +18,23 @@
```text
tjhlp-gitea/
├── ansible/ Ansible 自动化部署(Gitea + PostgreSQL)
├── deploy/ 测试使用的部署方案(如 Docker Compose)
├── issue-templates/ Issue 模板(按仓库类型区分)
└── scripts/ Python CLI 管理工具
```
## 快速开始
### 1. 部署服务器
### 1. 选择部署方式
本项目当前提供两种并行的单机部署方式:
- **Ansible**: 现有正式方案, 面向 Rocky Linux 8.10 主机, 直接安装 Gitea 二进制 + PostgreSQL + systemd
- **Docker Compose**: 测试方案, 面向单机容器部署, 默认只包含 Gitea + PostgreSQL, 反向代理/TLS 由外部处理
如果你使用 Docker Compose, 先参考 [deploy/compose/README.md](deploy/compose/README.md) 完成服务启动, 然后再回到下面的“初始化平台”步骤。
### 2. 使用 Ansible 部署服务器
需要一台 Rocky Linux 8.10 服务器和本地安装的 Ansible。
@@ -43,7 +53,7 @@ ansible-playbook playbook.yml
部署完成后, Ansible 会自动创建管理员账号并输出访问地址。
### 2. 初始化平台
### 3. 初始化平台
登录管理员账号, 在 **设置 -> 应用** 中创建 API Token, 然后:
@@ -58,7 +68,7 @@ uv run tjhlp setup init --org tjhlp-2025f
这会创建课程组织、ta/students 团队、general 答疑仓库, 并推送 Issue Template 和预定义 Label。
### 3. 导入用户
### 4. 导入用户
准备 CSV 文件(格式见 `scripts/example/members.csv`):
@@ -73,7 +83,7 @@ uv run tjhlp users create --file members.csv --org tjhlp-2025f
uv run tjhlp notify send-credentials --file credentials_*.csv
```
### 4. 创建作业仓库
### 5. 创建作业仓库
```bash
uv run tjhlp repos create-homework --org tjhlp-2025f --number 1
@@ -129,7 +139,7 @@ yamllint issue-templates/ # YAML 语法
| Git 平台 | Gitea(二进制 + systemd) |
| 数据库 | PostgreSQL 18 |
| 服务器 | Rocky Linux 8.10 |
| 部署工具 | Ansible |
| 部署工具 | Ansible / Docker Compose |
| 管理工具 | Python 3.14 + Typer + httpx + Pydantic + Dynaconf |
| 包管理 | uv |
| 测试框架 | pytest + respx + pytest-cov |