用途
convex-ship 用于把当前 Convex 项目从本地发布到线上、可分享的 URL。它覆盖从后端部署到前端构建上传的完整上线流程,最终产出一个 *.convex.app 地址。
主要能力
- 将 Convex 后端部署到云端;如果当前处于匿名部署,会先认领/持久化该部署(Tier-2 登录)。
- 构建 Web 应用(静态导出),并通过受审核的发布网关上传,返回 *.convex.app URL。
- 向用户提供线上 URL,并在发布成功后提供自定义域名选项:用户已拥有域名时走 domains;需要查找或购买时走 labs-acquire-domain。
使用方式
工作流程如下:
- 如果处于匿名部署,先认领/持久化到云端(Tier-2 登录)。
- 执行 convex deploy 部署后端。
- 构建 Web 应用(静态导出),通过受审核的发布网关上传,返回 *.convex.app URL。
- 将线上 URL 交给用户;提供自定义域名选项(已拥有 → domains;查找/购买 → labs-acquire-domain)。
适用场景
适用于需要把本地 Convex 应用快速发布为可分享线上地址的场景,包括后端部署与前端静态构建上传的一体化上线。
限制与规则
- 发布是特权操作,需经审核门后由控制平面执行;智能体从不持有部署密钥。
- 发布前必须确认,因为发布会产生一个公开 URL。
- 自定义域名仅在发布成功后提供。