跳到主要内容

通过 Git 仓库部署

云托管支持通过绑定 GitHub、GitLab 等个人或私有 Git 仓库进行应用部署，也支持直接通过公开 Git 仓库地址进行部署。两者适用场景和操作流程略有不同：

公开仓库部署​

  • 直接填写公开 Git 仓库地址（无需授权），如 GitHub/Gitee 等开源项目。
  • 适合开源项目、无需私密性和权限控制的场景。
  • 操作方式与私有仓库类似，但无需账号授权，适合快速体验和分享。

操作流程​

  1. 在云托管控制台选择“通过公开 Git 仓库地址部署”。
  2. 填写公开仓库的地址和分支，配置访问端口等参数。
  3. 保存并启动部署。

私有仓库部署​

  • 需授权绑定 GitHub、GitLab 等账号，支持私有和个人仓库。
  • 支持分支选择、构建参数配置、自动化触发部署（如 push、PR 合并等）。
  • 适合团队协作、持续集成（CI/CD）、自动化部署等场景。
  • 可结合 Webhook、CI 工具实现更复杂的自动化流程。

操作流程​

  1. 在云托管控制台选择“通过 Git 仓库部署”。
  2. 绑定您的 GitHub、GitLab 等代码仓库账号。
  3. 选择需要部署的私有或个人仓库及分支，配置构建参数。
  4. 配置自动化触发规则（如 push、PR 合并等）。
  5. 保存并启动部署。

启用自动部署​

私有仓库的最大优势是支持自动部署功能：

  1. 在服务创建或更新页面启用"自动部署"选项
  2. 系统会自动在 Git 平台配置 Webhook
  3. 此后，当指定分支有新的代码提交时：
    • Webhook 会自动触发云托管的部署流程
    • 系统拉取最新代码并构建新版本
    • 自动发布新版本到生产环境

配置完成后，后续每次代码变更（如 push、PR 合并）都会自动触发新的构建和部署，极大提升开发效率。

持续部署最佳实践​

分支策略​

  • 开发分支：用于日常开发工作，不触发自动部署
  • 测试分支：可配置自动部署到测试环境
  • 主分支：配置自动部署到生产环境，通常是 master 或 main

流程建议​

  1. 在开发分支进行功能开发和单元测试
  2. 通过 Pull Request/Merge Request 将代码合并到测试分支
  3. 自动部署到测试环境并进行集成测试
  4. 测试通过后，将代码合并到主分支
  5. 自动部署到生产环境

部署安全​

  • 启用自动部署前，确保 Dockerfile 已经过充分测试
  • 配置适当的构建超时时间，避免异常构建占用资源
  • 定期检查部署日志，确保部署过程正常
  • 保留多个历史版本，以便在新版本出现问题时快速回滚

故障处理​

  • 如果自动部署后服务异常，可在云托管控制台快速回退到之前的稳定版本
  • 检查构建日志和应用日志，定位问题原因
  • 修复问题后，重新提交代码触发新的部署

注意：首次使用自动部署功能时，建议先在非关键业务上测试，熟悉整个流程后再应用到核心服务。

开源项目示例​

项目（GitHub）简介一键部署链接
AI GatewayPortkey AI Gateway，开源 AI 网关，支持多模型路由与安全管控。一键部署
jsoncrack可视化 JSON 结构的开源工具，支持交互式编辑与分享。一键部署

如需详细操作指引，请参考云托管平台相关文档或联系技术支持。