用途:将当前目录中的 Microsoft App 构建并部署到云端,适用于用户要求通过 ms app deploy 发布应用的场景。
主要能力:提供标准部署(ms app deploy --commit <sha>)与带构建追踪的部署(ms app build + ms app build-status + ms app deploy)两条路径;部署前校验共享连接引用的 allowedActions、执行 npm run build 构建验证、同步 Git(add/commit/push)并确认后部署;部署成功后可打开线上应用或预览。
使用方式:先读取 memory-bank.md 获取应用 slug、GUID 与环境;用 test -f ms.config.json 与 git rev-parse 确认处于 Microsoft App 工作区与 Git 仓库;用 ms auth status 确认账号,异常时执行 ms auth login。选择部署路径后,运行 Node 脚本预检共享连接策略,再执行 npm run build,随后 git add -A、git commit、git push -u origin HEAD,取得 DEPLOY_SHA。部署前必须显式确认,再执行 ms app deploy --commit "$DEPLOY_SHA";追踪路径先 ms app build -c "$DEPLOY_SHA" 获取 build-id,再 ms app build-status -o "$BUILD_ID" 轮询至终态,最后部署。完成后更新 memory-bank.md 的部署时间、路径与提交 SHA。
适用场景:需要发布 Microsoft App 到指定环境的常规发布流程,或需要显式 build-id 追踪的部署。
限制:部署必须使用已推送的提交;共享连接引用缺少 allowedActions 会导致部署失败,需按最小权限补齐,不得删除 sharedConnectionId 绕过;构建失败需按规则处理(TS6133 移除后重试一次,其他 TS 错误报告并停止,模块缺失 npm install 后重试一次);认证过期需重新登录;环境不匹配需调整配置或环境;build-status 404 需核对 --cloud 集群;403 表示缺少目标环境的 Maker 权限。build 子命令已标记弃用但仍可用。