🚀 手动触发 Complete CI/CD Pipeline 工作流指南

✅ 工作流已找到!

您现在可以看到 "Complete CI/CD Pipeline" 工作流页面,并且可以手动触发它。

📋 表单参数说明

1. Branch (分支)

  • 默认值: master
  • 说明: 选择要部署的代码分支
  • 建议: 保持默认 master 分支

2. Deployment Environment (部署环境) ⭐ 必填

  • 选项: dev, staging, prod
  • 当前选择: dev
  • 说明:
    • dev - 开发环境(用于测试)
    • staging - 预发布环境(用于最终测试)
    • prod - 生产环境(正式发布)
  • 建议: 首次测试使用 dev

3. Deployment Region (部署区域) ⭐ 必填

  • 选项: cn, global
  • 当前选择: cn
  • 说明:
    • cn - 国内部署(使用国内CDN)
    • global - 国际部署(使用Cloudflare CDN)
  • 建议: 首次测试使用 cn

4. Language Version (语言版本)

  • 选项: all, zh-CN, en-US, ja-JP
  • 当前选择: all
  • 说明:
    • all - 构建所有语言版本
    • 特定语言 - 只构建指定语言
  • 建议: 首次测试使用 all

5. Deployment Type (部署类型) ⭐ 必填

  • 选项: cloudflare, cloud, both
  • 当前选择: cloudflare
  • 说明:
    • cloudflare - 仅部署到Cloudflare Tunnel
    • cloud - 仅部署到云服务器
    • both - 同时部署到Cloudflare和云服务器
  • 建议: 首次测试使用 cloudflare

6. Skip Tests (Emergency Only) (跳过测试)

  • 类型: 复选框
  • 当前状态: 未勾选
  • 说明:
    • ✅ 勾选 - 跳过所有测试(仅紧急情况使用)
    • ❌ 未勾选 - 运行完整测试套件
  • 建议: 保持未勾选,除非是紧急情况

🎯 推荐的首次测试配置

对于首次测试,建议使用以下配置:

Branch: master
Deployment Environment: dev
Deployment Region: cn
Language Version: all
Deployment Type: cloudflare
Skip Tests: ❌ 未勾选

🚀 触发工作流步骤

  1. 确认参数设置

    • 检查所有必填项都已填写
    • 确认参数值符合预期
  2. 点击 "Run workflow" 按钮

    • 页面右上角的绿色按钮
    • 点击后会立即触发工作流
  3. 等待工作流运行

    • 页面会自动跳转到运行历史
    • 可以看到工作流的实时执行状态
    • 每个步骤都会显示进度和日志
  4. 查看执行结果

    • ✅ 绿色勾号 = 成功
    • ❌ 红色叉号 = 失败
    • 🟡 黄色圆圈 = 进行中

📊 工作流执行流程

触发后,工作流将按以下顺序执行:

  1. 代码检查

    • 验证代码格式
    • 运行 linter
  2. 测试阶段

    • 单元测试
    • 集成测试
    • E2E测试(如果配置)
  3. 构建阶段

    • 构建Docker镜像
    • 构建i18n资源(如果选择特定语言)
  4. 部署阶段

    • 根据选择的部署类型执行部署
    • 更新Cloudflare Tunnel或云服务器
  5. 验证阶段

    • 健康检查
    • 部署验证

⚠️ 注意事项

开发环境 (dev)

  • ✅ 安全,可以随时测试
  • ✅ 不会影响生产环境
  • ✅ 适合日常开发和测试

预发布环境 (staging)

  • ⚠️ 接近生产环境
  • ⚠️ 需要谨慎操作
  • ✅ 用于最终测试

生产环境 (prod)

  • 🚨 高风险操作
  • 🚨 会影响真实用户
  • 🚨 建议先在dev和staging测试
  • 🚨 确保所有测试通过后再部署

🔍 查看工作流日志

工作流运行后,您可以:

  1. 查看实时日志

    • 点击运行中的工作流
    • 展开各个步骤查看详细日志
  2. 查看错误信息

    • 如果失败,日志会显示具体错误
    • 根据错误信息进行修复
  3. 重新运行失败的工作流

    • 修复问题后
    • 可以重新触发工作流

📚 相关文档

🆘 常见问题

Q: 工作流失败怎么办?

A: 查看日志找出错误原因,修复后重新触发。

Q: 可以同时运行多个工作流吗?

A: 可以,但建议等待当前工作流完成后再触发新的。

Q: 如何取消正在运行的工作流?

A: 在工作流运行页面点击 "Cancel workflow" 按钮。

Q: 部署需要多长时间?

A: 通常5-15分钟,取决于代码大小和测试复杂度。


现在可以点击 "Run workflow" 按钮开始您的首次CI/CD部署! 🎉