SHA256
forked from course-team/tjhlp-gitea
feat: 新增 Docker Compose 部署方案, 移除未验证的 ansible 草案
原 ansible/ 方案从未在任何环境验证过, 且与本机实际状态严重不符(硬编码
amd64 二进制、会覆盖生产 /etc/gitea/app.ini、会启动 firewalld 切断其它
服务、建的库名与现网不一致); 加上宿主机 Rocky 8 的系统 Python 无法升级,
新版 ansible 也跑不起来。改为 Docker Compose。
新增 deploy/:
- compose.yaml 版本锁定; Gitea 只发布 127.0.0.1:2080(Apache 反代无需
改动), PostgreSQL 不发布端口; 配置全部由
GITEA__section__KEY 环境变量注入; 数据用 bind mount
- db/Dockerfile 官方 postgres 只生成 en_US.UTF-8, 这里补 zh_CN.UTF-8,
与现有集群 collation 保持一致
- scripts/ backup.sh(pg_dump + 数据 tar + SHA256SUMS)、
restore.sh(默认 dry-run, 校验后还原, 拒收宿主布局备份)、
verify.sh(容器健康 + 回环 API + 经 Apache 反代)
文档 deploy/README.md 以 部署/备份/恢复/升级 四条流程为主线, 并记录本机
踩过的四个陷阱: PG18 挂载点、s6 chown 守卫、APP_NAME 只能走裸变量、
HTTP 代理导致的假 502。
一次性迁移脚本(install-docker / configure-docker-proxy / preflight /
migrate-from-binary)已清理, 相应步骤内联进文档。
实测: 源 116 表 → 目标 116 表, /api/healthz 200, 经 Apache /QA 200,
站点名与 OIDC 登录源注册正常。
This commit is contained in:
@@ -17,7 +17,7 @@
|
||||
|
||||
```text
|
||||
tjhlp-gitea/
|
||||
├── ansible/ Ansible 自动化部署(Gitea + PostgreSQL)
|
||||
├── deploy/ Docker 部署与运维(Gitea + PostgreSQL)
|
||||
├── issue-templates/ Issue 模板(按仓库类型区分)
|
||||
└── scripts/ Python CLI 管理工具
|
||||
```
|
||||
@@ -26,16 +26,18 @@ tjhlp-gitea/
|
||||
|
||||
### 1. 部署服务器
|
||||
|
||||
需要一台 Rocky Linux 8.10 服务器和本地安装的 Ansible。
|
||||
需要一台 Rocky Linux 8.10 服务器, 以及 Docker(含 compose 插件)。
|
||||
|
||||
```bash
|
||||
cd ansible
|
||||
# 编辑 inventory/hosts.yml 填入服务器地址
|
||||
# 编辑 inventory/group_vars/all.yml 修改域名、密码等
|
||||
ansible-playbook playbook.yml
|
||||
cd deploy
|
||||
cp .env.example .env # 填写地址、密钥、密码
|
||||
docker compose config --quiet # 校验 compose 与 .env 插值
|
||||
docker compose up -d --build
|
||||
sudo ./scripts/verify.sh # 体检
|
||||
```
|
||||
|
||||
部署完成后, Ansible 会自动创建管理员账号并输出访问地址。
|
||||
完整的部署步骤(Docker 安装、外网代理、RPM 冲突处理), 以及 **备份 / 恢复 / 升级**
|
||||
流程, 见 [`deploy/README.md`](deploy/README.md)。
|
||||
|
||||
### 2. 初始化平台
|
||||
|
||||
@@ -99,13 +101,13 @@ uv run pytest tests/ --cov=tjhlp --cov-report=term-missing # 带覆盖率
|
||||
- **API 客户端**(client.py)— 使用 [respx](https://lundberg.github.io/respx/) mock HTTP 层, 测试分页、错误处理、404 返回 None
|
||||
- **命令集成**— 使用 Typer CliRunner + mock 测试 setup/users/repos 命令的完整流程
|
||||
|
||||
### Ansible 静态检查
|
||||
### 部署配置检查
|
||||
|
||||
```bash
|
||||
cd ansible
|
||||
ansible-playbook --syntax-check playbook.yml # 语法检查
|
||||
yamllint -c .yamllint.yml . # YAML 格式
|
||||
ansible-lint playbook.yml # 最佳实践
|
||||
cd deploy
|
||||
docker compose config --quiet # 校验 compose 与 .env 插值
|
||||
sudo ./scripts/verify.sh # 部署后验证(容器健康 + API + 反代)
|
||||
./scripts/restore.sh --list # 查看可用备份及校验状态
|
||||
```
|
||||
|
||||
### Issue Templates 验证
|
||||
@@ -120,11 +122,11 @@ yamllint issue-templates/ # YAML 语法
|
||||
|
||||
| 组件 | 技术选型 |
|
||||
| ------ | ---------- |
|
||||
| Git 平台 | Gitea(二进制 + systemd) |
|
||||
| 数据库 | PostgreSQL 18 |
|
||||
| 服务器 | Rocky Linux 8.10 |
|
||||
| 部署工具 | Ansible |
|
||||
| Git 平台 | Gitea(Docker 容器) |
|
||||
| 数据库 | PostgreSQL 18(Docker 容器) |
|
||||
| 服务器 | Rocky Linux 8.10 (aarch64) |
|
||||
| 部署工具 | Docker Compose(见 `deploy/`) |
|
||||
| 管理工具 | Python 3.14 + Typer + httpx + Pydantic + Dynaconf |
|
||||
| 包管理 | uv |
|
||||
| 测试框架 | pytest + respx + pytest-cov |
|
||||
| 代码检查 | ruff, yamllint, ansible-lint |
|
||||
| 代码检查 | ruff, yamllint |
|
||||
|
||||
Reference in New Issue
Block a user