用途:该技能定义 Saleor 配置部署的最佳工作流顺序,覆盖 validate-diff-plan-deploy 流水线、每步的 JSON 信封解析、按实体下钻的失败恢复,以及基于报告的上下文收集。适用于“部署配置到店铺”“部署会有什么变化”“上次部署失败如何修复”“搭建部署流水线”以及围绕 CLI 构建 CI/CD 自动化。若需单个命令参数请用 configurator-cli,若需解析 JSON 输出结构请用 agent-output-parsing。
核心流程:第一步校验(无网络)pnpm dlx @saleor/configurator validate --json 2>/dev/null,若 result.valid 为 false 先修 config.yml;第二步只读 diff,若 totalChanges 为 0 表示已同步,若 hasDestructiveOperations 为 true 需警告删除;第三步预览 pnpm dlx @saleor/configurator deploy --plan --json 2>/dev/null,展示创建、更新、删除数量,若 willDeleteEntities 为 true 需明确警告并确认;第四步执行 pnpm dlx @saleor/configurator deploy --json 2>/dev/null,exitCode 为 0 成功,为 5 表示部分失败需下钻错误。
失败恢复:exitCode 为 5 时解析 .errors 数组,对失败实体用 diff --entity "Type/name" --json 下钻,分析字段级差异,修复 config.yml 后重新校验并部署。可先查看历史部署报告(deployment-report-*.json)获取上下文。
退出码:0 成功;1 意外,检查 .errors 与 .logs;2 认证,核对 SALEOR_URL 与 SALEOR_TOKEN;3 网络,确认 URL 可达;4 校验,运行 validate 修复;5 部分失败,下钻修复重部署;6 删除被阻止,展示删除并确认;7 破坏性变更被阻止,展示并确认。
凭据来自 .env.local(自动加载)或环境变量:SALEOR_URL(须以 /graphql/ 结尾)、SALEOR_TOKEN。安全规则:部署前始终校验,执行前始终展示 diff/plan,明确警告删除,CI/CD 中使用 --fail-on-delete,解析 JSON 信封而非抓取文本,非 TTY 环境自动进入非交互模式。相关技能:configurator-cli、agent-output-parsing、configurator-troubleshoot。