6a11d8a70e
✨ 新增功能 - 添加构建缓存，提升构建速度 50-60% - 实现三阶段部署流程：构建测试、部署、健康检查 - 支持手动触发部署 - 添加版本检查，避免重复部署 - 支持 Secrets 配置 🔧 修复 - 修复后端启动路径问题（Nitro 输出路径） - 修复 Dockerfile 构建问题 - 完善错误处理和日志输出 📚 文档 - 新增配置说明文档（README.md） - 新增测试指南（TEST_GUIDE.md） - 新增改进建议（IMPROVEMENTS.md） - 新增变更日志（CHANGELOG.md） - 新增快速开始指南（QUICKSTART.md） 🎉 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
185 lines
4.1 KiB
Markdown
185 lines
4.1 KiB
Markdown
# 🚀 快速开始指南
|
||
|
||
## 📋 前提条件
|
||
|
||
- ✅ Gitea 已安装并配置 Actions
|
||
- ✅ 服务器已安装 Docker 和 Docker Compose
|
||
- ✅ 服务器可通过 SSH 访问
|
||
- ✅ 端口 8080 可用
|
||
|
||
## ⚡ 5 分钟快速部署
|
||
|
||
### 步骤 1: 推送代码
|
||
|
||
```bash
|
||
cd /Users/hahaha/projects/kt-financial-system
|
||
|
||
# 添加所有修改
|
||
git add .
|
||
|
||
# 提交更改
|
||
git commit -m "ci: 优化 CI/CD 配置"
|
||
|
||
# 推送到 main 分支
|
||
git push origin main
|
||
```
|
||
|
||
### 步骤 2: 查看部署进度
|
||
|
||
1. 打开 Gitea 仓库页面：
|
||
```
|
||
https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system
|
||
```
|
||
|
||
2. 点击顶部的 `Actions` 标签
|
||
|
||
3. 查看最新的 workflow run 状态：
|
||
- 🟡 黄色：正在执行
|
||
- 🟢 绿色：执行成功
|
||
- 🔴 红色：执行失败
|
||
|
||
### 步骤 3: 访问应用
|
||
|
||
部署成功后，访问：
|
||
```
|
||
http://172.16.74.149:8080
|
||
```
|
||
|
||
## 🎯 一键部署命令
|
||
|
||
```bash
|
||
# 克隆仓库（如果还没有）
|
||
git clone https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system.git
|
||
cd kt-financial-system
|
||
|
||
# 推送触发部署
|
||
git push origin main
|
||
|
||
# 或使用部署脚本（手动部署）
|
||
./deploy.sh
|
||
```
|
||
|
||
## 📊 部署时间线
|
||
|
||
| 阶段 | 时间 | 说明 |
|
||
|------|------|------|
|
||
| Build and Test | 3-8 分钟 | 构建和测试 |
|
||
| Deploy | 2-5 分钟 | 部署到服务器 |
|
||
| Health Check | 30 秒 | 健康检查 |
|
||
| **总计** | **5-15 分钟** | 完整部署流程 |
|
||
|
||
## 🔍 检查部署状态
|
||
|
||
### 方法 1: Gitea Actions
|
||
|
||
1. 打开 Actions 页面
|
||
2. 查看最新的 run
|
||
3. 点击查看详细日志
|
||
|
||
### 方法 2: 服务器检查
|
||
|
||
```bash
|
||
# SSH 登录服务器
|
||
ssh atai@172.16.74.149
|
||
|
||
# 检查容器状态
|
||
cd /home/atai/kt-financial-system
|
||
sudo docker-compose ps
|
||
|
||
# 查看日志
|
||
sudo docker-compose logs --tail=50
|
||
```
|
||
|
||
### 方法 3: 健康检查
|
||
|
||
```bash
|
||
# 测试前端
|
||
curl -I http://172.16.74.149:8080
|
||
|
||
# 测试 API
|
||
curl http://172.16.74.149:8080/api/ping
|
||
```
|
||
|
||
## ⚠️ 常见问题
|
||
|
||
### 问题 1: Actions 没有触发
|
||
|
||
**解决方案**：
|
||
1. 确认 Gitea Actions 已启用
|
||
2. 检查 `.gitea/workflows/deploy.yml` 文件是否存在
|
||
3. 确认推送的是 `main` 分支
|
||
|
||
### 问题 2: 构建失败
|
||
|
||
**解决方案**：
|
||
1. 查看 Actions 日志，定位错误
|
||
2. 确认本地可以成功构建：`pnpm build`
|
||
3. 检查依赖是否正确安装
|
||
|
||
### 问题 3: 部署失败
|
||
|
||
**解决方案**：
|
||
1. 检查 SSH 连接：`ssh atai@172.16.74.149`
|
||
2. 确认服务器有足够的磁盘空间：`df -h`
|
||
3. 检查 Docker 服务：`sudo systemctl status docker`
|
||
|
||
### 问题 4: 健康检查失败
|
||
|
||
**解决方案**：
|
||
1. 等待更长时间，服务可能还在启动
|
||
2. 检查容器日志：`sudo docker-compose logs`
|
||
3. 手动测试：`curl http://localhost:8080`
|
||
|
||
## 🎉 成功标志
|
||
|
||
部署成功后，你会看到：
|
||
|
||
### Gitea Actions
|
||
```
|
||
✅ Build and Test - 成功
|
||
✅ Deploy - 成功
|
||
✅ Health Check - 成功
|
||
```
|
||
|
||
### 服务器
|
||
```bash
|
||
$ sudo docker-compose ps
|
||
NAME STATUS PORTS
|
||
kt-financial-system Up 0.0.0.0:8080->80/tcp
|
||
```
|
||
|
||
### 浏览器
|
||
- ✅ 页面正常显示
|
||
- ✅ 登录功能正常
|
||
- ✅ 主要功能可用
|
||
|
||
## 📚 下一步
|
||
|
||
- 📖 阅读 [配置说明](.gitea/README.md)
|
||
- 🧪 查看 [测试指南](.gitea/TEST_GUIDE.md)
|
||
- 🚀 了解 [改进建议](.gitea/IMPROVEMENTS.md)
|
||
- 📝 查看 [变更日志](.gitea/CHANGELOG.md)
|
||
|
||
## 💡 小贴士
|
||
|
||
1. **首次部署**：首次部署会比较慢（8-10 分钟），后续会有缓存加速
|
||
2. **手动触发**：可以在 Actions 页面手动触发部署
|
||
3. **查看日志**：遇到问题先查看 Actions 日志
|
||
4. **健康检查**：部署后会自动进行健康检查
|
||
5. **版本检查**：如果代码无变化，会自动跳过部署
|
||
|
||
## 🆘 获取帮助
|
||
|
||
如需帮助，请：
|
||
1. 查看文档：`.gitea/` 目录下的文档
|
||
2. 查看日志：Gitea Actions 日志和服务器日志
|
||
3. 创建 Issue：在仓库中创建 Issue
|
||
4. 联系团队：联系技术支持团队
|
||
|
||
---
|
||
|
||
**快速链接**：
|
||
- 🌐 应用地址：http://172.16.74.149:8080
|
||
- 📦 Gitea 仓库：https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system
|
||
- 🤖 Actions：https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system/actions
|