快速开始

本指南演示如何通过 LAS Portal 完成第一次部署。

准备 GitHub 仓库

仓库必须是公开仓库，并包含 .qiniu/deploy.yaml。最小配置如下：

version: 1
installCommand: npm ci
startCommand: npm run start -- --host 0.0.0.0 --port 3000
port: 3000
healthcheck:
  path: /
  timeoutSeconds: 60

启动命令必须启动一个持续运行的 HTTP 服务，服务监听地址必须包含 0.0.0.0。配置字段详见部署配置文件。

使用官方测试仓库

如果你只是想验证一键部署流程，可以直接使用公开的独立测试示例仓库 qiniu/deployment-test。该仓库不是一键部署服务的组成部分或运行时依赖，只是用于演示和联调，并且已经包含可用的 .qiniu/deploy.yaml，当前配置为：

version: 1
workingDirectory: .
installCommand: npm ci && npm run build
startCommand: npm run start
port: 4173
healthcheck:
  path: /
  timeoutSeconds: 60

该仓库的两个 branch 都可以直接用于部署测试：

该仓库仅用于演示和联调，代码内容可能随时变更。它不是一键部署服务的组成部分或运行时依赖，平台不会依赖该仓库运行，也不会自动将它作为你的生产业务代码来源；生产部署应替换为你自己维护的 GitHub 仓库。Tag 部署可以使用你自己的公开 GitHub 仓库进行验证。

创建部署

1. 登录 LAS Portal，进入 一键部署，点击 新建部署。
2. 输入 GitHub 仓库的 owner/repository 或完整 GitHub URL。
3. 选择 branch 或 Tag。平台会读取仓库并将所选引用固定为完整 Commit SHA；后续引用变化不会修改已创建的 Revision。
4. 确认配置文件路径、安装命令、启动命令、端口和健康检查路径。
5. 选择可用的 Sandbox 区域和模板，确认费用和服务协议。
6. 点击 确认并部署，进入部署详情页。
7. 等待 Revision 完成代码拉取、依赖安装、服务启动和健康检查。
8. Revision 状态变为 ready 后，从详情页打开服务地址。

部署结果

提交后页面会立即进入详情页。部署过程是异步的，提交成功不等于服务已经启动。刷新页面不会丢失任务，Deployment ID 会用于恢复部署进度。

如果部署失败，请打开当前 Revision 的日志，按照故障排查检查对应阶段。修复仓库后，处于 failed、cancelled 或 expired 状态的 Deployment 可以重新部署。

费用和清理

部署会创建真实 Sandbox 资源。暂时不使用服务时，请在详情页点击 停止；不再需要保留部署历史时，请点击 删除。停止和删除都可能先显示处理中，请等待页面显示最终状态。