Blizzard
41f3fb7fb0
- deploy.yml 触发条件 dev → main；PR 合并进 main 产生的 push 同样覆盖 - 文档同步：日常开发走 dev，合并 main 才上线 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
60 lines
2.1 KiB
Markdown
60 lines
2.1 KiB
Markdown
# 部署说明
|
||
|
||
## 拓扑
|
||
|
||
```
|
||
push/merge main ─▶ Gitea(192.168.100.125:3000)
|
||
│ 触发 .gitea/workflows/deploy.yml
|
||
▼
|
||
act_runner(192.168.100.128)
|
||
│ docker build → save → scp
|
||
▼
|
||
部署机(192.168.100.132) /home/workspace/sundynix-site
|
||
│ docker load → compose up → 容器 :8090
|
||
│ │ 连
|
||
│ MySQL(192.168.100.127:3307)
|
||
▼
|
||
内网穿透 ──▶ 公网服务器 nginx ──▶ https://site.sundynix.cn
|
||
```
|
||
|
||
## 一次性准备
|
||
|
||
### 1. Gitea 仓库 Secrets（仓库 → Settings → Actions → Secrets）
|
||
|
||
| Secret | 值 |
|
||
|--------|-----|
|
||
| `DEPLOY_HOST` | `192.168.100.132` |
|
||
| `DEPLOY_USER` | `root` |
|
||
| `DEPLOY_PASSWORD` | `sundynix` |
|
||
|
||
### 2. 部署机 132 准备
|
||
|
||
```bash
|
||
# 装好 docker + compose 插件后：
|
||
mkdir -p /home/workspace/sundynix-site
|
||
cd /home/workspace/sundynix-site
|
||
# 放置生产配置（参考仓库 .env.production.example）
|
||
vi .env # 改 admin 密码、JWT 密钥
|
||
```
|
||
|
||
`.env` 关键项见 [.env.production.example](../.env.production.example)。数据库指向内网 `192.168.100.127:3307/sundynix_site`（库不存在会自动建表 + 种子）。
|
||
|
||
### 3. act_runner 128 要求
|
||
|
||
- 能访问 docker daemon（`docker build/save` 可用）
|
||
- 能 ssh 到 132（workflow 用 sshpass 走密码）
|
||
|
||
### 4. 公网服务器 nginx
|
||
|
||
1. 内网穿透把 132:8090 映射到公网机本地端口
|
||
2. 用 [nginx-site.sundynix.cn.conf](nginx-site.sundynix.cn.conf) 配置反代，改 `upstream` 为穿透实际端口
|
||
3. 证书：`certbot certonly --webroot -w /var/www/certbot -d site.sundynix.cn`
|
||
|
||
## 日常
|
||
|
||
- 提交或合并到 `main` 分支自动构建部署；也可在 Gitea Actions 页手动 `workflow_dispatch`
|
||
- 日常开发在 `dev` 分支，PR 合并进 `main` 才触发上线
|
||
- 回滚：132 上 `docker tag` 保留的旧镜像，或重跑上一次成功的 commit
|
||
- 查日志：`docker logs -f sundynix-site`
|
||
- 本地手动出包（不走 CI）：仓库根 `docker build -t sundynix-site:latest .`
|