Skip to content

AUTO_DEPLOY_GUIDE.md

Latest commit

 

History

History
160 lines (116 loc) · 3.96 KB

AUTO_DEPLOY_GUIDE.md

File metadata and controls

160 lines (116 loc) · 3.96 KB

🚀 全自动部署指南

基于求是思想 - 实事求是，找到最简单有效的方案！

📊 方案总览

我们使用 平台原生集成 实现全自动部署，比 GitHub Actions 更简单可靠！

GitHub (代码)
    │
    ├──→ Cloudflare Pages (前端自动部署)
    │
    └──→ Render (后端自动部署)

🎯 第一步：前端 - Cloudflare Pages (5分钟)

1. 访问 Cloudflare Dashboard

https://dash.cloudflare.com/b009d274cb9dc02032faf28b57926c4a/workers-and-pages

2. 创建 Pages 项目

  • 点击 Create application
  • 选择 Pages 标签
  • 点击 Connect to Git（不是 Upload assets）

3. 连接 GitHub 仓库

  • 选择 mingli-ai 仓库
  • 选择 main 分支

4. 配置构建设置

配置项 值
项目名称 mingli-frontend
框架预设 Vite
构建命令 cd mingli-frontend && npm install && npm run build
构建输出目录 mingli-frontend/dist

5. 环境变量（可选）

如果需要连接后端，添加：

VITE_API_URL=https://mingli-backend.onrender.com

6. 点击 Save and Deploy

✅ 完成！ 以后每次 push 到 main 分支都会自动部署！

🎯 第二步：后端 - Render (5分钟)

1. 访问 Render

https://render.com

2. 创建 Web Service

  • 登录后点击 New → Web Service
  • 选择 mingli-ai 仓库

3. 配置部署

配置项 值
Name mingli-backend
Region 选择离你最近的（Singapore 或 Hong Kong）
Branch main
Runtime Python 3
Build Command cd mingli-backend && pip install -r requirements.txt
Start Command cd mingli-backend && uvicorn app.main:app --host 0.0.0.0 --port $PORT
Plan Free

4. 点击 Create Web Service

✅ 完成！ 以后每次 push 到 main 分支都会自动部署！

🔄 自动部署工作原理

开发者 push 代码到 GitHub main 分支
    ↓
┌─────────────────────────────────────┐
│  Cloudflare Pages 检测到更新        │
│  - 自动拉取代码                     │
│  - 自动执行构建                     │
│  - 自动部署到全球 CDN               │
└─────────────────────────────────────┘
    ↓
┌─────────────────────────────────────┐
│  Render 检测到更新                  │
│  - 自动拉取代码                     │
│  - 自动安装依赖                     │
│  - 自动启动服务                     │
└─────────────────────────────────────┘

✅ 验证部署

验证前端

访问：https://mingli-frontend.pages.dev

验证后端

访问：https://mingli-backend.onrender.com

测试 API

curl https://mingli-backend.onrender.com/

📝 部署检查清单

  • Cloudflare Pages 连接 GitHub 仓库成功
  • Cloudflare Pages 第一次部署成功
  • Render 连接 GitHub 仓库成功
  • Render 第一次部署成功
  • 前端可以访问
  • 后端 API 可以访问
  • 前后端可以正常通信

🎉 完成！

现在你的项目已经实现全自动部署了！

以后只需要：

git add .
git commit -m "更新内容"
git push

Cloudflare Pages 和 Render 会自动处理部署！

🆘 常见问题

Q: 部署失败怎么办？ A: 查看 Cloudflare Pages 和 Render 的部署日志，根据错误信息调整。

Q: 如何自定义域名？ A: 在 Cloudflare Pages 和 Render 的设置中都可以添加自定义域名。

Q: 免费额度够用吗？ A: Cloudflare Pages 免费版完全够用，Render 免费版有 750 小时/月，适合开发测试。