SHA256
forked from course-team/tjhlp-gitea
docker: 添加使用docker部署的方法用于快速测试 (#2)
添加使用docker部署的方法**用于快速测试** 路径于`deploy\compose`,目录下有相应部署指导文档 本次改动还将一些配置置为 example,在 git 中取消追踪**以免误操作将敏感信息提交** Reviewed-on: https://cpp.tongji.sh:2080/jkljkluiouio/tjhlp-gitea/pulls/2 Co-authored-by: oierxjn <[email protected]> Co-committed-by: oierxjn <[email protected]>
This commit was merged in pull request #2.
This commit is contained in:
@@ -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 |
|
||||
|
||||
Reference in New Issue
Block a user