用途:本技能覆盖 Storefront Next 店面的构建与部署,将其作为 bundle 发布到 Managed Runtime(MRT)。sfnext CLI 负责构建与推送 bundle,环境配置通过 MRT 环境变量管理。可复用 Business Manager 店面设置创建的 MRT 项目、环境与凭据,无需每次部署都新建 SLAS 客户端或 MRT 资源。
主要能力:生产构建(pnpm build,输出到 build/ 目录,编译 TypeScript、分别打包客户端与服务端代码、优化压缩资源、生成静态 Page Designer 注册表);推送部署(pnpm run push,可加 --message 指定消息、--environment 指定环境并 --wait 等待);环境变量配置(通过 Runtime Admin 或 b2c mrt env var set/push 设置,PUBLIC__ 值会合并进运行时配置且浏览器可见,变更会重新部署环境;也可用 CLI 标志或 MRT_* 环境变量控制推送目标,.env 文件仅用于本地开发);Page Designer 卡匣部署(pnpm generate:cartridge、pnpm deploy:cartridge、pnpm deploy:cartridge:clean、pnpm validate:cartridge,卡匣元数据也会在 pnpm build 时自动生成)。
使用方式:部署流程为 pnpm run build → pnpm run push → MRT 接收 bundle → 部署到环境。推送前需先构建,因为 push 命令依赖已有构建输出。MRT_PROJECT 为推送必需的项目 slug,MRT_TARGET 为可选目标环境,省略时 bundle 仅上传不部署。可用 b2c mrt env var push --file .env.staging --project <project> --environment <environment> 显式应用已审查的文件,该命令会显示差异并提示。实时日志优先使用 MCP 的 mrt_logs_watch / mrt_logs_watch_poll,CLI 替代为 b2c mrt tail-logs。
适用场景:Storefront Next 店面的源码部署与预发/生产发布。
限制与检查:部署前应运行 pnpm test、pnpm bundlesize:test、确认目标环境变量齐全、pnpm build 无错误、SCAPI 凭据与目标环境匹配。常见问题包括构建因 TypeScript 错误失败(可运行 pnpm typecheck)、推送因认证问题被拒、部署后 500 错误(缺少环境变量)、Page Designer 组件陈旧(卡匣未部署)。Page Designer 元数据需单独部署到 Commerce Cloud,而非 MRT。具体收费、价格与平台细节暂未提供。