kt-financial-system/.gitea/QUICKSTART.md

🚀 快速开始指南

📋 前提条件

• ✅ Gitea 已安装并配置 Actions
• ✅ 服务器已安装 Docker 和 Docker Compose
• ✅ 服务器可通过 SSH 访问
• ✅ 端口 8080 可用

⚡ 5 分钟快速部署

步骤 1: 推送代码

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

🎯 一键部署命令

# 克隆仓库（如果还没有）
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: 服务器检查

# SSH 登录服务器
ssh atai@172.16.74.149

# 检查容器状态
cd /home/atai/kt-financial-system
sudo docker-compose ps

# 查看日志
sudo docker-compose logs --tail=50

方法 3: 健康检查

# 测试前端
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 - 成功

服务器

$ sudo docker-compose ps
NAME                    STATUS              PORTS
kt-financial-system     Up                  0.0.0.0:8080->80/tcp

浏览器

• ✅ 页面正常显示
• ✅ 登录功能正常
• ✅ 主要功能可用

📚 下一步

• 📖 阅读 配置说明
• 🧪 查看 测试指南
• 🚀 了解 改进建议
• 📝 查看 变更日志

💡 小贴士

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