SuperAPI AI 工具集

b2c-import-set-migrations

部署与运维

查看项目

更新于 10-16 08:44

技能介绍

用途:把站点导入导出归档按既定顺序、幂等地应用到 B2C Commerce 实例。b2c job import-set 先处理发现的自定义卡带 metadata/ 目录,再处理项目 migrations 目录(默认 ./migrations)。每个归档在每个实例上只应用一次,后续运行自动跳过,适合本地初始化、开发者入职与 CI/CD 反复执行。这是可选、需项目主动采用的方案,不是默认工作流;若只是偶发单次站点导入,应改用 b2c-cli:b2c-site-import-export 技能。

主要能力:归档发现与排序(卡带按名称、来源内归档按字典序);--dry-run 预览待应用与已应用归档且不写入实例;--no-cartridge-metadata 仅导入项目迁移;--import-set-exclude 递归排除项目相对目录(可重复或逗号分隔,也可写入 dw.json、package.json 的 b2c.importSetExclude、SFCC_IMPORT_SET_EXCLUDE);--keep-archive 保留上传归档;--set-id 维护独立导入历史(默认 migrations);--json 输出机器可读状态与计数;并发运行自动协调,锁默认 30 分钟后可恢复,可用 --break-lock 立即恢复。

用法与结构:归档目录或 zip 需符合标准站点导入导出结构。每个有序子归档命名 YYYYMMDDTHHmmss-description,使用 UTC;已应用的归档不得修改或改名,应新增更晚排序的归档。目录型归档顶层的 README.md 记录需人工后续步骤,运行后会汇总打印本次新应用归档的备注;zip 不扫描 README。凭证与实例通过 SFCC_* 环境变量、dw.json 及配置插件自动发现,需同时具备 OAuth 与 WebDAV 凭证,可用 b2c setup inspect 确认。未全局安装 b2c 时使用 npx @salesforce/b2c-cli。

适用场景:本地环境搭建、团队入职、CI/CD 部署步骤(可配合 b2c job import-set --json > import-set-result.json);从实例导出构建迁移时应先参考 b2c-config、b2c-job、b2c-site-import-export、b2c-content、b2c-metadata 等相关技能,并清理无关数据、version.txt、环境相关值与密钥。

限制:无专门的重置命令,建议改用新 set-id 或通过 b2c webdav rm --root=impex b2c-cli/import-sets/migrations 清除后再运行;清空历史会使所有归档重新待应用。归档必须可安全重复应用(中断重试可能重跑当前归档)。本技能及具体平台版本要求等更多细节资料暂未提供。